Metadata-Version: 2.4
Name: qt-kurarin
Version: 0.1.2b1
Summary: Prototype multi-window Qt reconstruction of Kyukurarin desktop MV effects.
Requires-Python: >=3.12
Requires-Dist: pyqt6==6.11.0
Description-Content-Type: text/markdown

![Qt-Kurarin](https://socialify.git.ci/VincentZyuApps/Qt-Kurarin/image?custom_description=Qt-powered+Kyuukurarin+%28%E3%81%8D%E3%82%85%E3%81%86%E3%81%8F%E3%82%89%E3%82%8A%E3%82%93%29+on+your+desktop+%E2%80%94+animated+sprites+in+sync+with+the+music+&description=1&forks=1&issues=1&language=1&logo=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2Fthumb%2F0%2F0b%2FQt_logo_2016.svg%2F960px-Qt_logo_2016.svg.png&name=1&owner=1&pulls=1&stargazers=1&theme=Auto)

# Qt-Kurarin Python Prototype

> Qt-powered Kyuukurarin (きゅうくらりん) on your desktop — animated sprites in sync with the music

> **[📖 English](README.md)**
> **[📖 简体中文(大陆)](README.zh-cn.md)**
> **[📖 日本語](README.jp.md)**

This is a PyQt6 reconstruction track for validating the core effect of the [original project](https://github.com/VincentZyu233/Win-kurarin):

- multiple independent top-level windows
- transparent backgrounds
- timeline-driven movement
- fade in / fade out
- always-on-top presentation

The current build reads:

- `data/script.txt`
- `resources/audio.mp3`
- `resources/*.png`

## Run from source

```shell
git clone https://github.com/VincentZyuApps/Qt-Kurarin
cd Qt-Kurarin/python
uv venv --python 3.12
uv pip install -r ./requirements.txt
uv run python -m qt_kurarin.main
uv run python -m qt_kurarin.main --frame-style none
uv run python -m qt_kurarin.main --frame-style win11
uv run python -m qt_kurarin.main --frame-style mac
uv run qt-kurarin --frame-style none --verbose
uv run qt-kurarin --frame-style win11 --verbose
uv run qt-kurarin --frame-style mac --verbose
```

## Run from PyPI
```shell
rm -r ./.venv/ # if already exist
uv venv --python 3.12
uv pip install qt-kurarin
# uv pip install qt-kurarin --index-url https://pypi.org/simple  # use official index if mirrors are not latest
uv run qt-kurarin
uv run qt-kurarin --frame-style none
uv run qt-kurarin --frame-style win11
uv run qt-kurarin --frame-style mac
uv run qt-kurarin --frame-style none --verbose
uv run qt-kurarin --frame-style win11 --verbose
uv run qt-kurarin --frame-style mac --verbose
``` 
