β¨ Download and display album art or display embedded album art β¨
kunst
is a daemon that extracts the album art from the songs playing in mpd
and displays them in the a little window. It doesn't loop on a timer, instead it waits for mpd
to send a player
event. When it receives a player
event, it wakes up and extracts the album art of the current playing track. This makes kunst
really lightweight and makes it idle at ~0%
CPU usage. If there no embbeded album art, it will try to fetch the album art from the internet.
Dependencies
sxiv
bash
ffmpeg
mpc
jq
mpd
Installation
make
Install using # Clone the repo
$ git clone https://github.com/sdushantha/kunst
# Change your current directory to kunst
$ cd kunst
# Install it
$ sudo make install
Install it locally
# Download the kunst source code, save as kunst, make it executeable
# and then move it to ~/.local/bin
$ curl -L git.io/raw-kunst > kunst && chmod +x kunst && mv kunst ~/.local/bin
Usage
$ kunst --help
usage: kunst [-h] [--size px] [--music_dir path/to/dir] [--silent] [--version]
β¬βββ¬ β¬ββββββββ¬β
ββ΄ββ βββββββ β
β΄ β΄βββββββββ β΄
Download and display album art or display embedded album art
optional arguments:
-h, --help show this help message and exit
--size what size to display the album art in
--position the position where the album art should be displayed
--music_dir the music directory which MPD plays from
--silent dont show the output
--version show the version of kunst you are using
Configure
You can configure kunst
through environment variables.
# The size of the album art to be displayed
export KUNST_SIZE="250x250"
# The position where the album art should be displayed
export KUNST_POSITION="+0+0"
# Where your music is located
export KUNST_MUSIC_DIR="/home/username/Music/"
License
MIT License
Copyright Β© 2019 Siddharth Dushantha