An mpd client with album art and basic functionality.
Project description
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:
- Cloning this repository to your computer and running
python setup.py install
- Through PyPi with
pip install miniplayer
- 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
-
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
pixcat
andueberzug
If you are not using Kitty, tryueberzug
.
mpd
- host: The mpd host
- port: The mpd port
Keybinds
Key | function |
---|---|
h | Show keybinds |
p | Play/pause |
> | Next track |
< | Last track |
q | Quit |
+ | Volume +5 |
- | Volume -5 |
F.A.Q.
-
Q: Album art is not showing up.
A: Make sure yourmusic_directory
is not quoted i.e. if your music directory is~/My Music
then your config should look likemusic_directory = ~/My Music
.
If this does not work, try changingimage_method
frompixcat
toueberzug
or vice versa. -
Q: Album art is too big/too small.
A: You need to configurefont_height
andfont_width
. Their values should be the actual pixel height and width of a character in your terminal.
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.
Source Distribution
Built Distribution
Hashes for miniplayer-1.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f33ce43d836ce042f0059ed1ab6861b89febe21c685c3df01a3cbf91d8a243ed |
|
MD5 | 9e26ad8fe685613e42de6126469aaa45 |
|
BLAKE2b-256 | 286eb63f6e5ff29f7e103f8827e3e52c03e68125356127fcfb303f688ac69ca3 |