Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jeffmhubbard/mpnotd-zsh
:notes: :speech_balloon: MPD Notification Daemon (Zsh)
https://github.com/jeffmhubbard/mpnotd-zsh
cava cover-art mpd-album-art mpd-notification-daemon notification zsh
Last synced: 1 day ago
JSON representation
:notes: :speech_balloon: MPD Notification Daemon (Zsh)
- Host: GitHub
- URL: https://github.com/jeffmhubbard/mpnotd-zsh
- Owner: jeffmhubbard
- License: mit
- Created: 2020-02-26T23:10:29.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-01-30T13:43:43.000Z (almost 4 years ago)
- Last Synced: 2023-11-17T16:33:42.000Z (12 months ago)
- Topics: cava, cover-art, mpd-album-art, mpd-notification-daemon, notification, zsh
- Language: Shell
- Homepage:
- Size: 3.35 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MPD Notification Daemon
Watches MPD for song change and takes action
### Features
- Gathers detailed song info
- Searches filesystem and online for cover art
- Configurable, independent actions
- Popup - Display song info and cover via [libnotify](https://gitlab.gnome.org/GNOME/libnotify)
- Cava - Change [cava](https://github.com/karlstav/cava) color based on cover art
- Cover - Display cover art on desktop with [feh](https://feh.finalrewind.org/)
- Write - Write current song info to file for easy parsing
### Requirements
- zsh
- mpc
- curl
- jq
- imagemagick
- libnotify
- cava (optional)
- feh (optional)
### Installation
Manual:
```sh
git clone https://github.com/jeffmhubbard/mpnotd-zsh
cd mpnotd-zsh
sudo make install
```
### Usage
To start from terminal:
`mpnotd --time 20 -u low --cava -w cur.txt`
```
-C, --config specify path to config file
-p, --popup enable notifications (defaults on)
-t, --time time to display popup (in seconds)
-u, --urgency urgency level (low, normal, critical)
-v, --cava enable cava color
-c, --cover enable cover mode
-w, --write enable output file
-D, --debug verbose output
-h, --help print help
```
### Configuration
```sh
# ~/.config/mpnotd/mpnotd.rc
# number of days to cache cover art for
CACHE_DAYS=10
# set title of popup
POPUP_SUBJECT=" Now Playing"
# (if set) format popup body
POPUP_BODY="%title%\n%By %artist%\nFrom %album% (%date%)"
# time to display popup (seconds)
POPUP_DURATION=30
# popup urgency (low, normal, critical)
POPUP_LEVEL=low
# change cava fg color based on cover art
CAVA_ENABLE=true
# (if set) palette to use instead of dominant color
CAVA_COLORS=(fc391f 31e722 eaec23 5833ff f935f8 14f0f0)
# show cover art on desktop
COVER_ENABLE=true
# cover art size
COVER_SIZE=200x200
# cover art position
COVER_POSITION=+20+20
# (if set) time to display cover art
COVER_DURATION=10
# write current song info to file
WRITE_ENABLE=true
# (if set) key-value separator
WRITE_SEP="|"
```
### Notes
For floating cover art with i3
```ini
for_window [class="mpnotd"] floating enable
no_focus [class="mpnotd"]
```