Skip to content
master
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Feb 16, 2019
Feb 12, 2019
Feb 17, 2019

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

About

πŸ–ΌοΈ Download and display album art or display embedded album art

Topics

Resources

License

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.