kunst/README.md at 8a746ed66753c828242495137dd125c4528de951

2.2 KiB

Raw Blame History

_{✨ Download and display album art or display embedded album art ✨}

kunst is a deamon 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 kunstreally 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
imagemagick
bash
ffmpeg
mpc
jq

Installation

Install using `make`

# 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
# and make it executeable
$ curl git.io/raw-kunst > kunst && chmod +x kunst

# Then move kunst to somewhere in your $PATH
# Here is an example
$ mv kunst ~/script/

Install from the AUR

AUR (maintained by networkpanic)

Usage

$ kunst --help
usage: kunst [-h] [--size px] [--music_dir path/to/dir] [--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
   --music_dir           the music directory which MPD plays from
   --version             show the version of kunst you are using

License

MIT License

2.2 KiB Raw Blame History