MadhavMusicCLI 🎵

A Termux-first terminal music player — stream YouTube, manage playlists, view lyrics, all inside your terminal.

✨ Features

🚀 Installation

Termux (Android) — Recommended

# 1. Install Python + audio tools
pkg install python mpv

# 2. (Optional) Install Termux:API app from F-Droid for termux-media-player support

# 3. Install MadhavMusicCLI
pip install madhavmusiccli

# 4. Launch!
music

Linux / macOS / Windows

pip install madhavmusiccli
music

Note: On desktop, install pygame for audio:

pip install madhavmusiccli pygame

🎮 Usage

music                          # launch with auto-detected music folder
music --library ~/Music        # specify music directory
music --theme dracula          # start with Dracula theme
music --version                # show version

⌨️ Key Bindings

🔌 Audio Backends (Auto-detected)

MadhavMusicCLI automatically picks the best backend:

🔌 Plugin System

Add custom music providers via pyproject.toml entry-points:

[project.entry-points."madhavmusiccli.providers"]
myprovider = "mypkg.provider:MyProvider"

Subclass MusicProvider from madhavmusiccli.plugins.base.

🛠️ Development

git clone <your-repo>
cd CLI_music
pip install -e ".[dev]"
pytest -q
music

📦 Upload to PyPI

See PYPI_UPLOAD.md for full instructions.

upload_pypi.bat --test   # TestPyPI first
upload_pypi.bat          # real PyPI

📄 License

MIT — see LICENSE