aboutsummaryrefslogtreecommitdiff
path: root/README.markdown
blob: df02fec6907119f9f56f71d9662dfefdd75e8bc3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
mpdlrc
======

Print timed lyrics from an LRC file for MPD's currently playing song
line-by-line to `stdout`: <https://en.wikipedia.org/wiki/LRC_%28file_format%29>

Needs `Net::MPD` and a few core Perl packages. Expects to find lyrics named
`Artist - Title.lrc` in `~/.lyrics`. An LRC file I made for Darkthrone's "To
Walk The Infernal Fields" from their 1993 album "Under a Funeral Moon" is
included for testing.

This code is not great. It will be improved. It needs to be more configurable
from environment variables or options, for one thing.

This could maybe be used with `libnotify` or a similar desktop notification
tool to display lyrics in a corner as you work on other things. I've included a
simple Bash wrapper around `notify-send(1)` which works for me.

You can install both with `make install`. The default `PREFIX` is `/usr/local`.
You may prefer `$HOME/.local`, like I do.

License
-------

Copyright (c) [Tom Ryder][1]. Distributed under [Artistic License 2.0][2].

[1]: https://sanctum.geek.nz/
[2]: http://opensource.org/licenses/artistic-license-2.0