kunst/README.md

51 lines
1.6 KiB
Markdown
Raw Normal View History

2019-02-19 15:28:32 +00:00
<p align="center"><img src="extra/kunst_logo.png"><br><sub>✨ Download and display album art or display embedded album art ✨</sub></p>
2019-02-15 07:07:34 +00:00
2019-02-19 13:32:39 +00:00
```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. If there no embbeded album art, it will try to fetch the album art from the internet. This maks ```kunst```really lightweight and makes it idle at ```~0%``` CPU usage.
2019-02-13 17:37:37 +00:00
<p align="left">
<img src="extra/demo.gif" width="657.8" height="438.1">
</a>
</p>
2019-02-12 18:52:56 +00:00
## Dependencies
2019-02-13 17:37:37 +00:00
- ```sxiv```
- ```imagemagick```
- ```bash```
2019-02-15 17:59:21 +00:00
- ```ffmpeg```
- ```mpc```
2019-02-14 05:25:04 +00:00
## Installation
2019-02-17 12:57:31 +00:00
```sudo make install```
**OR**
2019-02-19 13:27:11 +00:00
Add ```kunst``` to a directory which is in your ```$PATH```
2019-02-14 05:27:02 +00:00
2019-02-17 06:17:28 +00:00
**OR**
[AUR](https://aur.archlinux.org/packages/kunst-git/) *(maintained by [networkpanic](https://github.com/networkpanic))*
2019-02-17 06:17:28 +00:00
2019-02-19 17:01:45 +00:00
## Usage
```bash
$ kunst --help
usage: kunst [-h] [--size px] [--music_dir path/to/dir] [--version]
┬┌─┬ ┬┌┐┌┌─┐┌┬┐
├┴┐│ ││││└─┐ │
┴ ┴└─┘┘└┘└─┘ ┴ 1.0
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 bum you are using
```
2019-02-14 08:14:19 +00:00
## License
MIT License
Copyright © 2019 Siddharth Dushantha