Rainy
Rainy runs on a computer you own, like a home server, a NAS with Docker, or your desktop. Every other device just opens it in a browser or installs the app.
Public on GitHub
There’s no tagged release yet, so these archives are the latest code on the main branch.
Install Docker (Docker Desktop on macOS and Windows), then grab the code.
git clone https://github.com/Rainer-Technologies/Rainy.git && cd RainyCreate your config, then set FLASK_SECRET_KEY, MYSQL_PASSWORD, MYSQL_ROOT_PASSWORD and MUSIC_LIBRARY_PATH.
cp .env.example .envStart it. No NVIDIA GPU? Delete the deploy: block in compose.yaml first.
docker compose up --build -dOpen http://localhost:6969, create the administrator account and set the library path to /music. Then run Quick Scan under Settings → Maintenance.
You’ll need Python 3.11+, ffmpeg and a JS runtime (Deno, Node or Bun).
brew install python ffmpeg nodeGrab the code.
git clone https://github.com/Rainer-Technologies/Rainy.git && cd RainyRun the start script. It creates the virtualenv, installs requirements and copies .env. No MySQL? Set RAINY_DB=sqlite.
./start.shOpen http://localhost:6969, create the administrator account and enter the absolute path to your music folder. Then run Quick Scan under Settings → Maintenance.
You’ll need Python 3.11+, ffmpeg and a JS runtime (Deno, Node or Bun). Or use the Docker tab.
sudo apt install python3 python3-venv ffmpeg nodejsGrab the code.
git clone https://github.com/Rainer-Technologies/Rainy.git && cd RainyStart it. Add --gunicorn for production workers. No MySQL? Set RAINY_DB=sqlite.
./start.shOpen http://localhost:6969, create the administrator account and enter the absolute path to your music folder. Then run Quick Scan under Settings → Maintenance.
Install Python 3.11+, ffmpeg and a JS runtime (Deno, Node or Bun). Or use Docker Desktop.
winget install Python.Python.3.12 Gyan.FFmpeg OpenJS.NodeJSGrab the code.
git clone https://github.com/Rainer-Technologies/Rainy.gitRun the start script from the Rainy folder. No MySQL? Set RAINY_DB=sqlite in .env.
start.batOpen http://localhost:6969, create the administrator account and enter the absolute path to your music folder. Then run Quick Scan under Settings → Maintenance.
Need a secret key?
python -c "import secrets; print(secrets.token_hex(32))"Yes. Rainy is MIT licensed with no subscription and no paid tier. Some optional dependencies and models use other licenses. The repository’s third-party notices list them.
No. Rainy runs on your hardware. Audio analysis, genre classification, lyrics alignment and recommendations are all computed locally, with no API keys required.
No. Light show analysis uses every CPU core (about 2.8 s for a 216 s track on a Ryzen 5 5600X). An NVIDIA GPU makes it faster, with identical results.
Yes. Rainy is multi-user, with per-account libraries, user and sysadmin roles, friends, and shared playlists with admin or viewer collaborators.
Install it as a PWA on your phone for lock-screen controls and media keys, cast to Chromecast, and use Rainy Connect to move playback between devices.
Yes, including whole playlists and syncs that keep them up to date. Only import music you own or have permission to download, and follow the law where you live.