mpvd

Control mpv using the MPD protocol

git clone https://git.8pit.net/mpvd.git

 1# mpvd
 2
 3Control [mpv][mpv homepage] using the [MPD][mpd homepage] [protocol][mpd protocol].
 4
 5## Status
 6
 7A toy project for playing around with [libmpdserver][libmpdserver github]
 8and the [hy][hy homepage] programming language. Buggy and totally
 9incomplete at the moment.
10
11## Installation
12
13Setup [libmpdserver][libmpdserver github] using:
14
15	$ git clone --recursive https://github.com/nmeum/libmpdserver
16	$ make -C libmpdserver libmpdserver.so
17
18Install [hy][hy homepage] and [mpv][mpv homepage], start mpv using:
19
20	$ mpv --input-ipc-server=/tmp/mpvsock some-file.opus
21
22Afterwards, start mpvd using:
23
24	$ export LD_LIBRARY_PATH="<PATH TO LIBMPDSERVER REPOSITORY>"
25	$ hy mpvd.hy /tmp/mpvsock
26
27## Usage
28
29Very simple interactions with [mpc][mpc homepage] are possible, for example:
30
31	$ mpc --host localhost --port 6600 pause
32	OpenBSD - Trial of the BSD Knights
33	[paused]  #1/1   0:03/3:04 (1%)
34	volume: 84%   repeat: off   random: off   single: off   consume: off
35
36If [mpc][mpc homepage] is installed test can be invoked using:
37
38	$ ./tests/run_tests.sh
39
40## License
41
42This program is free software: you can redistribute it and/or modify it
43under the terms of the GNU Affero General Public License as published by
44the Free Software Foundation, either version 3 of the License, or (at
45your option) any later version.
46
47This program is distributed in the hope that it will be useful, but
48WITHOUT ANY WARRANTY; without even the implied warranty of
49MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
50General Public License for more details.
51
52You should have received a copy of the GNU Affero General Public License
53along with this program. If not, see <https://www.gnu.org/licenses/>.
54
55[mpv homepage]: https://mpv.io/
56[mpd homepage]: https://musicpd.org/
57[mpd protocol]: https://musicpd.org/doc/html/protocol.html
58[libmpdserver github]: https://github.com/nmeum/libmpdserver
59[hy homepage]: https://docs.hylang.org
60[mpc homepage]: https://www.musicpd.org/clients/mpc/