the CLI music player
Project description
cMusic
A simple CLI music player written in Python.
PS: it's recommended to use the GitHub monaspace font(s) with ligatures enabled to use the player, but it's not required.
Also, there's a bug in pygame's mixer that causes the music to do strange things when paused for an extended period of time, so I recommend not pausing the music for too long (12 hours or more). I can't really do anything about it, so you'll have to deal with it.
NOTICE
Although this player can play any audio file, I do not condone piracy. Please only use this player to play music that you own or have the rights to play. By using this player, you agree to take full responsibility for any legal consequences that may arise from your use of this player.
Installation
cmusic is available on PyPI, so you can install it using pip.
pip install cmusic
(please make sure that your python scripts directory is in your PATH)
or you can install it from the source code.
git clone
cd cmusic
pip install .
Usage
# play a Song (must be in the current directory, you can ignore file extensions)
cmusic play <Song> [--loop] [--shuffle]
pssst, you can also pass multiple Songs to play them in a row._
cmusic play <Song1> <Song2> <Song3> ...
The player will display the current Song playing, the progress of the Song and the controls.
NOW PLAYING: Altars of Apostasy by Heaven Pierce Her (Ultrakill: Imperfect Hatred (Original Game Soundtrack))
─────────█────────────────────
<< || >> 01:44 / 05:37 ────○ 🔊 100% 🔁
if you want, you can activate background mode by adding the --background
flag to the command.
cmusic play <Song> --background
it will play the Song in the background, and you can continue using the terminal.
note: if you want to return to the player, you can use cmusic c
Music Controls
to control the music when it's not in the background, you can use the following keys:
space
to pause/play the Song.q
to quit the player.shift + (+)
to increase the volume.shift + (-)
to decrease the volume.e
to enter background mode.
commands
cmusic list
to list all the songs in the library.cmusic play <Song>
to play a Song.cmusic version
to display the version of the player.cmusic search <query>
to search for Songs in the library.
background mode commands
cmusic p
to pause/play the current Songcmusic v <volume>
to change the volume of the player.cmusic c
to return to the player.cmusic q
to quit the player.
playlist commands
cmusic playlist create <name> <song>(s)
to create a playlist.cmusic playlist add <name> <song>(s)
to add a Song to a playlist.cmusic playlist remove <name> <song>(s)
to remove a Song from a playlist.cmusic playlist delete <name>
to delete a playlist.cmusic playlist list
to list all the playlists.cmusic playlist list <name)
to list all the Songs in a playlist.cmusic play <playlist name> --playlist
to play a playlist.
Development setup
To set up the development environment, you need to have Poetry and python 3.12+ installed on your system.
git clone https://github.com/kokonico/cmusic
cd cmusic
poetry install
to install the player to use it in the terminal, you can use the following command.
poetry run pip install .
License
This project is licensed under the Zlib License. See the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.