9P file server for controlling mpv playback.
Toy project for experimenting with neinp. Currently provides a very buggy, incomplete, and unfinished implementation of playlistfs. To work properly a patch for mpv is required mpv.
Install using go install as follows:
$ go install github.com/nmeum/mpvfs@latest
This software relies on mpv's IPC mechanism. Currently, mpv must be started separately. For instance, as:
$ mpv --keep-open=yes --idle --pause --input-ipc-server=/tmp/mpv-socket song.flac
Afterwards, mpvfs itself must be started as:
$ ./mpvfs -a localhost:9999 /tmp/mpv-socket
The created 9P server can than be mounted using any 9P implementation. Examples are given below. On Plan 9 derivatives, it is possible to partially control playback using the games/jukebox client for playlistfs.
Several 9P implementations are available for Unix-like operating systems. Most notably, plan9port provides 9pfuse a fuse-based implementation of 9P. Using 9pfuse, mount the file server as follows:
$ 9pfuse 127.0.0.1:9999 /media/9p/
Afterwards, interaction with the playctl, playvol, and playlist
files provided at the given mount point is possible. For instance, echo play >> /media/9p/playctl will start playback. Please refer to the
playlistfs manual for more information on the
provided files.
Notes on v9fs: The Linux kernel provides v9fs, an in-tree implementation of the 9P protocol. Unfortunately, this implementation does not work correctly with playlistfs as it continues reading data from files after EOF has been received which doesn't work with playlistfs as it blocks until new data is available when the callee tries to continue reading after EOF.
If you are running Plan 9 in QEMU you need to create a corresponding
guestfwd rule, e.g. guestfwd=tcp:10.0.2.4:1234-cmd:"nc 127.0.0.1 9999".
If you want to use jukebox, you might also need to create
/sys/lib/music/map, refer to the juke man page for more
information.
Mount mpvfs on /n/mpvfs using srv(4):
% srv -m net!10.0.2.4!1234 mpvfs /n/mpvfs
If jukebox is available, add the resources to the /mnt union directory:
% bind -b /n/mpvfs/ /mnt/
Finally, start jukefs and jukebox as follows:
% games/jukefs
% games/jukebox
Controlling playback through the buttons in the top left corner should work, changing volume should also work fine. Everything else is a bit wonky at the moment.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.