Skip to content
/ mpvc Public
forked from lwilletts/mpvc

An mpc-like control interface for mpv.

License

Notifications You must be signed in to change notification settings

woorst/mpvc

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mpvc

An mpc-like control interface for mpv.

mpvc also has a nearly complete compatibility layer for mpc commands in addition to GNU-style arguments.

Check the mpc manpage for details.

ExampleOutput

Dependencies

  • mpv
  • socat or nc, socat preferred due to the differing implementations of netcat across UNIXes.
  • seq or jot

Install

Distribution Packages:

  • Arch - pacaur -y mpvc-git
  • Crux - prt-get depinst mpvc
  • Gentoo - emerge mpvc
  • Nixos - nix-env -i mpvc

If you have packaged mpvc for your distribution, let me know so I can add it here.

Manual Install

Use the Makefile provided or copy mpvc somewhere to your $PATH.

Usage

For mpvc to work, mpv must be started with the following argument:

$ mpv --input-ipc-server=/tmp/mpvsocket song.flac

Alternatively and probably preferably, mpvc can be used with the -a or --add option to add files to the current playlist:

$ mpvc -a *

However, mpv does not resolve individual files in a directory unless it is currently in or has been inside that directory, giving misleading results about the total number of files in the current playlist. A handy alternative is to use find to pipe files directly into mpvc:

$ find . -type f | mpvc

You could use a subshell, but it won't phrase files with spaces in them correctly. This unfortunately is a limit of shell.

Useful Tricks

  • Hotkey daemons like sxhkd can be used to bind mpvc commands to key combinations.
  • Any URL that is resolvable by mpv and/or youtube-dl can be added to the playlist, i.e. using mps-youtube with player set to mpvc and playerargs set to add.
  • mpvc options can be combined together to give improved results: $ mpvc -P -j 1 will make mpvc always start playing when switching to the next track.

TODO

Check out the Issue Tracker

Shameless Plug

If you want to contact me about anything, my website can be found here and I can also be found on the Freenode IRC under the nick 'Wildefyr' where I am often found in #crux and #6c37. If you're feeling particularly kind of heart, star this repository and/or follow me.

About

An mpc-like control interface for mpv.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 99.1%
  • Makefile 0.9%