A rhythm game that runs entirely in your terminal. Notes fall, you hit them. Built with Python.
⚠️ Early development — expect rough edges.
Claudia works with any MP3 you own. Drop it in the songs/ folder and run the analyzer to generate a chart:
python analyze.py "songs/your song.mp3"The game will pick it up automatically next time you launch.
A few tracks are bundled to get you started (see CREDITS).
git clone https://github.com/pinguinosod/claudia
cd claudia
pip install -r requirements.txt
python main.pyPython 3.10+ recommended.
| Key | Action |
|---|---|
| D F J K | Hit lanes (rebindable in-game) |
| ESC | Pause |
| W / S | Navigate menus |
| Enter | Confirm |
Lane keys can be rebound from the main menu → Key Bindings.
- Rich — terminal rendering
- pygame — audio playback
- librosa — beat detection & chart generation
- pyfiglet — ASCII art
MIT — see LICENSE.
Music and audio assets have separate licenses — see CREDITS.