A curses based mpd client with basic functionality and album art.
After installation, the player can be opened from the terminal with
This package can be installed by:
- Cloning this repository to your computer and running
python setup.py install
- Through PyPi with
pip install miniplayer
- By installing the
miniplayer-gitpackage with your AUR package manager of choice.
The config file is located at
~/.config/miniplayer/config. The example configuration file,
config.example, has all the default values. You will need to create the file yourself.
- music_directory: The path to your music directory for extracting album art.
- font_width: The width of your font in pixels in the actual terminal.
- font_height: The height of your font in pixels in the actual terminal.
- image_method: The method to use for drawing album art. Available values are
If you are not using Kitty, try
- volume_step: The ammount (in percents) the volume will be adjusted on pressing the volume up and volume down keys.
- album_art_only: Whether or not to only draw the album art and no other track info (
- auto_close: Whether or not to automatically close the player once the mpd playlist has concluded (
- show_playlist: Whether or not to show the playlist view.
- host: The mpd host
- port: The mpd port
- pass: The mpd password
This section allows you to change the keybinds for the player. The format for a keybind is
key = action (for example
p = play_pause or
left = last_track). Available actions are
|Enter||Play selected song|
These keybinds can be changed by editing the config file. See the
config.example file for the format.
Q: Album art is not showing up.
A: Make sure your
music_directoryis not quoted i.e. if your music directory is
~/My Musicthen your config should look like
music_directory = ~/My Music.
If this does not work, try changing
ueberzugor vice versa.
Q: Album art is too big/too small.
A: You need to configure
font_width. Their values should be the actual pixel height and width of a character in your terminal.