Modern minimal terminal music player. Searches YouTube, streams via mpv or any preferred audio player.

For windows: pip install yt-dlp rich

For Linux & MAC: pip install yt-dlp rich --break-system-packages

Install mpv separately. Install yt-dlp.

Interactive mode

python music.py

Type a song title to search. Results appear as a numbered table — enter a number to play, d3 to download #3. Navigate with single-letter shortcuts: l library, h history, , settings, 0 exit.

Direct play

python music.py "Teri Ore"

Searches, shows results, plays the first match. No prompts.

Play directly:

python music.py "Bheegi Si Bhaagi Si"
python music.py "Linkin park - Numb"
python music.py "Best of Mozart"

music "Bheegi Si Bhaagi Si"  
music "Linkin Park - Numb"
music "Best of Mozart"

Open interactive mode:

music

Use Music-CLI directly from terminal after setting it up properly from the given steps:

music "Bheegi Si Bhaagi Si"

This command directly plays the music directly. This is the simplest way to listen music.

Add to ~/.bashrc or ~/.zshrc:

alias music='python ~/music-cli/music.py'

Here, replace ~/music-cli/music.py with the appropriate path.

Reload shell:

source ~/.bashrc

Open PowerShell profile:

notepad $PROFILE

Add:

function music {
    python "C:\path\music.py" $args
}

Here, replace C:\path\music.py with the appropriate path.

Restart PowerShell.

• Searches your local history and YouTube simultaneously. Local matches appear first (marked ⊘), online results after (◈).
• Streams by default. Set auto_download: true in settings to cache on play.
• Downloaded songs go to ~/Music (Linux/macOS/Windows). Configurable.
• Play history and downloads tracked in a local SQLite database (music.db).

Accessible from the interactive menu (,). Stored in config.json next to music.py.

MIT