kunst/README.md

57 lines
2.3 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-20 09:34:53 +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. 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.
2019-02-13 17:37:37 +00:00
<p align="left">
2019-02-20 09:31:29 +00:00
<img src="https://media.giphy.com/media/5WieRVgCvD4H0V53QY/giphy.gif">
2019-02-13 17:37:37 +00:00
</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-19 17:28:30 +00:00
**Install using ```make```**
```bash
sudo make install
```
**Install it locally**
2019-02-17 12:57:31 +00:00
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-19 17:28:30 +00:00
**Install from the AUR**
2019-02-17 06:17:28 +00:00
[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
2019-02-20 16:05:11 +00:00
> If `kunst` ever gets super slow or stops grabbing album art and needs to restart, that means it has *Kunstipated*
>
> &ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;20 February 2019, [u/SpicyBroseph](https://www.reddit.com/user/SpicyBroseph)
2019-02-19 17:01:45 +00:00
```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
2019-02-20 16:35:44 +00:00
--version show the version of kunst you are using
2019-02-19 17:01:45 +00:00
```
2019-02-14 08:14:19 +00:00
## License
MIT License
Copyright © 2019 Siddharth Dushantha