Minimal command-line music player written in Python.

Designed with elegance and minimalism.

Resizes dynamically with your terminal.


pyms uses pygame & pynput, which can be installed by executing:

pip3 install pygame
pip3 install pynput

It has been tested with Python 3.8.10, results may vary if other versions are used.


The following commands will download the latest version of pyms from this repository
and install it in your /usr/bin/ directory:

git clone
cd pyms
chmod +x pyms
sudo cp pyms /usr/bin/

The program can now be ran from a terminal with the command pyms.


Execute the following command to play the song passed as an argument:

pyms <song.mp3>