SIGPLAY

A terminal music player with a retro-modern vibe. Built with Python and Textual.

What it does

• Plays music from your ~/Music folder (MP3, WAV, OGG, FLAC)
• Keyboard-driven interface with vim-style navigation
• Real-time audio visualization
• Floppy Mix: AI-powered DJ mixing using natural language instructions

What it looks like

Run

First, install uv if you don't have it:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then run:

uvx sigplay

That's all! No other things needed.

Controls

Key	Action
j/k	Navigate track list
Enter	Play selected track
Space	Play/Pause
s	Stop
n/p	Next/Previous track
+/-	Volume up/down
m	Mute
r	Shuffle
f	Floppy Mix (AI DJ)
d	Back to main view
h or ?	Help
q	Quit

Floppy Mix

Press f to open the AI DJ mixer. Select tracks, write instructions in plain English, and let the AI create a mix.

Example instructions:

• "Mix these with smooth 4-second crossfades"
• "Boost the bass and add reverb"
• "Create a high-energy mix with compression"

Requires an OpenRouter API key. You can set it as an environment variable or enter it when prompted:

export OPENROUTER_API_KEY="your-key-here"
export SIGPLAY_MIX_MODEL_ID="anthropic/claude-haiku-4.5"  # optional

Requirements

• uv installed
• Audio files in ~/Music

License

MIT