Supports Windows, macOS, and Linux
Automatically refresh weekly with the latest code changes, may contain AI hallucinations
Do not use IME during playback. Use US-QWERTY direct input only.
# Install
git clone https://github.com/x15rte/Jukebox.git
cd Jukebox/
sudo apt install libasound2-dev libjack-dev (Linux)
pip install -r ./requirements.txt (Mac/Linux)
pip install -r ./requirements-windows.txt (Windows)
# Run
python ./main.py
# Update
git pullDownload and run the latest release from the Releases page.
the frozen exe may show the window with a random delay;if nothing appears, wait a bit longer or run via Method1
Use MIDI output to support velocity
KEY Mode: 88-Key -> Ctrl ; Pedal -> Space
Open config dir
cd ~/.jukebox_piano/
You can verify it in several ways:
- Review the source code yourself (itโs fully open source).
- Use AI tools like Claude or DeepWiki to analyze the code.
- Run it directly with
python main.pywithout downloading any executable. (Recommended method)
Alternatively, if you prefer to use the pre-built executable from the Immutable release:
- It is built automatically via GitHub Actions (see build.yml).
- Immutable releases
- You can scan it on VirusTotal before running.
pyinstaller ./Jukebox.spec
This project is based on HuMidi