Miniplayer

A curses based mpd client with basic functionality and album art.

After installation, the player can be opened from the terminal with miniplayer.

Installation

This package can be installed by:

1. Cloning this repository to your computer and running

python setup.py install

2. Through PyPi with

pip install miniplayer

3. By installing the miniplayer-git package with your AUR package manager of choice.

Configuration

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.

player

Wow, that volume step is huge. Why isn't my album art centered?

Option	Description
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.
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 (true/false).
auto_close	Whether or not to automatically close the player once the mpd playlist has concluded (true/false).
show_playlist	Whether or not to show the playlist view.

The font_width and font_height options are used to center the album art properly.Here is an example of how they should be measured.

art

Why listen to music if you can't look at the pretty album art?

Option	Description
image_method	The method to use for drawing album art. Available values are pixcat and ueberzug.

mpd

Tell me your mpd address please!

Option	Description
host	The mpd host
port	The mpd port
pass	The mpd password

keybindings

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).

To use shift as a modifier, capitalize the keybinding (i.e. shift + p becomes P and shift + left becomes Left). This only works for alpha keys and the arrow keys!

Available actions
play_pause
next_track
last_track
volume_down
volume_up
toggle_info
help
quit
select_down
select_up
select
move_up
move_down
shuffle
repeat
delete
command_line

theme

Make it yours!

Option	Description
accent_color	The color to use for selections in the playlist
bar_color	The color for the progress bar
time_color	The color for the time stamp
bar_body	A single character to use for the body of the progress bar
bar_head	A single character to use for the head of the progress bar
command_sep	Characters used to seperate the command line
command_char	Characters to indicate the command line is open

The following terminal colors can be used:

• black
• red
• green
• yellow
• blue
• magenta
• cyan
• white

You can also use the magic colour called auto. If you pick it, the player will try to determine the dominant color in the album art and use that instead.

Default keybinds

Key	Function
h	Show keybinds
p	Play/pause
>	Next track
<	Last track
q	Quit
+	Volume up
-	Volume down
i	Toggle info
Up	Selection up
Down	Selection down
Enter	Play selected song
Delete	Remove selected song from playlist
Shift + up	Move selected song up
Shift + down	Move selected song down
x	Shuffle playlist
r	Toggle repeat
:	Open command line

These keybinds can be changed by editing the config file. See the config.example file for the format.

The command line

The command line can be used to add songs to the current playlist. To launch it, press the command_line button (that's : by default). The command line supports some tab completion but you cannot move the caret left or right (yet).

The format is as follows:

[hierarchy] [tag1/tag2/tag3/...tagN]

• You do not have to populate all the tags. if you type, for example, artist Phoebe Bridgers/ and hit enter, all of Phoebe's music in your library will be added to the playlist.

• NOTE You do not type the seperator! It is added automatically. Just use a space!

The hierarchy controls the order of the tags and what each tag represents. Currently there are 4 available hierarchies with plans to add user configurable ones in the future.

Hierarchies

Hierarchy	Tag format
album	album/song
artist	artist/song
song	song
aa	artist/album/song

Command line keys

Key	Action
Escape	Exit command line
Enter	Attempt to add the current tags to the playlist

F.A.Q.

• Q: Album art is not showing up.
  A: Try changing image_method from pixcat to ueberzug or vice versa.

• Q: Album art is too big/too small.
  A: You need to configure font_height and font_width. Their values should be the actual pixel height and width of a character in your terminal.

More screenshots!