qt-kurarin 0.2.2b1

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

💡 Generate your own wallpaper: wallpaper/gen_wallpaper.py

Run from source

git clone https://github.com/VincentZyuApps/Qt-Kurarin
# or from gitee: 
git clone https://gitee.com/vincent-zyu/qt-kurarin
cd Qt-Kurarin/python
uv venv --python 3.13
uv pip install -r ./requirements.txt
uv run python -m qt_kurarin.main [OPTIONS]

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 [OPTIONS]

Options

Flag	Description	Default
--frame-style <STYLE>	Window frame style: none, win11, mac	none
-v, --verbose	Print live sprite playback details to the console	off
-t, --textual-tui	Show live playback details in a Textual TUI	off
--hide-taskbar-button	Hide the taskbar/dock icon (Win: ✅, macOS: 🟡 may hide, Linux: ❓ depends on compositor)	off
-l, --loudness <0-100>	Audio loudness percentage	100

Examples

uv run qt-kurarin
uv run qt-kurarin --help
uv run qt-kurarin --frame-style win11 --textual-tui
uv run qt-kurarin --frame-style mac --verbose
uv run qt-kurarin --loudness 60