qt-kurarin 0.1.2

Prototype multi-window Qt reconstruction of Kyukurarin desktop MV effects.

Qt-Kurarin Python Prototype

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

📖 English 📖 简体中文(大陆) 📖 日本語

This is a PyQt6 reconstruction track for validating the core effect of the original project:

• 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

git clone https://github.com/VincentZyuApps/Qt-Kurarin
cd Qt-Kurarin/python
uv venv --python 3.13
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

rm -r ./.venv/ # if already exist
uv venv --python 3.13
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