A command line Youtube music player written in python. It’s an app written for Linux. It also supports offline playlists that are stored in a playlists.db file. More documentation coming soon.


  • pip3 install youtube-dl youtube-search-python pyfiglet
  • mpv has to be installed – check your distro’s install method
  • python3
  • an audio server
  • a kernel

You can install all the pip3 requirements by running ‘pip3 install -r requirements.txt’

After launching main.py in your terminal, type in ‘man’ to print a manual on how to use the program.

You can replace main.py with your own script – maybe you want a GUI, or keyboard shortcuts from anywhare using the keyboard library? I made the program modular so if you throw away main.py you discard only the input method.