music-cli

(β˜… 84)

A command-line music player for coders. Background daemon with radio streaming, local MP3s, and AI-generated music.

  • .gitignore
  • .pre-commit-config.yaml
  • AGENTS.md
  • CHANGELOG.md
  • CLAUDE.md
  • CODE_OF_CONDUCT.md
  • CODE_REVIEW.md
  • constraints-dev.txt
  • CONTRIBUTING.md
  • install.sh
  • LICENSE
  • MODERNIZATION_PLAN.md
  • MODERNIZATION_REPORT.md
  • music-cli-ai.gif
  • original-prompt.png
  • pyproject.toml
  • README.md
  • SECURITY.md

# Installation Guide

1. Get the code
git clone https://github.com/luongnv89/music-cli

Downloads the entire project code from GitHub to your computer.

cd music-cli

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended
Prerequisites
  • Python 3 Python is required to use pip.
  • Homebrew A package manager for macOS/Linux.
curl -fsSL https://raw.githubusercontent.com/luongnv89/music-cli/main/install.sh | bash

Downloads and runs the official install script in one line β€” this handles the full setup automatically.

wget -qO- https://raw.githubusercontent.com/luongnv89/music-cli/main/install.sh | bash

Type this command into your terminal and run it.

pip install coder-music-cli

Installs the package published on PyPI directly β€” no need to clone the source.

brew install ffmpeg # macOS

Installs the pre-built package via Homebrew β€” no source build required.

βœ… After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy
Prerequisites
  • Git Needed to download the project code from GitHub.
  • Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.
pip install coder-music-cli

Installs the package published on PyPI directly β€” no need to clone the source.

pip install 'coder-music-cli[youtube]'

Installs the package published on PyPI directly β€” no need to clone the source.

pip install 'coder-music-cli[ai]'

Installs the package published on PyPI directly β€” no need to clone the source.

pip install 'coder-music-cli[minimax]'

Installs the package published on PyPI directly β€” no need to clone the source.

pip install 'coder-music-cli[youtube,ai]'

Installs the package published on PyPI directly β€” no need to clone the source.

βœ… If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation