Go to file
M.B. Christiansen e8f9deab43 Wrap usage to fit within 80 characters 2022-10-10 11:30:41 +02:00
extra added better demo gif 2020-01-29 12:18:12 +01:00
.SRCINFO add PKGBUILD 2019-02-16 20:40:14 +01:00
.editorconfig Chore: format using `shfmt` 2020-03-06 07:27:30 -08:00
LICENSE Initial commit 2019-02-12 19:50:25 +01:00
Makefile Add Makefile 2019-02-17 12:57:31 +00:00
PKGBUILD Remove imagemagick dependency 2020-02-29 01:25:33 -08:00
README.md fixed spelling mistake, fixes #42 2020-08-21 19:21:02 +02:00
kunst Wrap usage to fit within 80 characters 2022-10-10 11:30:41 +02:00

README.md


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 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 or imv
  • bash
  • ffmpeg
  • mpc
  • jq
  • mpd

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, 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