MPV: Difference between revisions

m Updated Troubleshooting section to work with the changes to the mpv-package as in https://github.com/NixOS/nixpkgs/pull/474601
DHCP (talk | contribs)
m style fixes
 
(One intermediate revision by one other user not shown)
Line 19: Line 19:


==== With nix-shell ====
==== With nix-shell ====
<syntaxhighlight lang="bash" start="3">
<syntaxhighlight lang=console>
nix-shell -p mpv
$ nix-shell -p mpv
</syntaxhighlight>
</syntaxhighlight>


==== With NixOS ====
==== With NixOS ====
<syntaxhighlight lang="text">
 
<syntaxhighlight lang=nix>
environment.systemPackages = [
environment.systemPackages = [
  pkgs.mpv
  pkgs.mpv
Line 30: Line 31:
</syntaxhighlight>
</syntaxhighlight>
==== With Home Manager ====
==== With Home Manager ====
<syntaxhighlight lang="text">home.packages = [  
<syntaxhighlight lang=nix>
home.packages = [  
   pkgs.mpv  
   pkgs.mpv  
];</syntaxhighlight>'''With mpvScripts'''<syntaxhighlight lang="nix">{ pkgs, ... }:
];
</syntaxhighlight>'''With mpvScripts'''<syntaxhighlight lang="nix">
{ pkgs, ... }:
{
{
   environment.systemPackages = with pkgs; [
   environment.systemPackages = with pkgs; [
Line 47: Line 51:


==== Basic ====
==== Basic ====
<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
programs.mpv.enable = true;
programs.mpv.enable = true;
Line 52: Line 57:


==== Advanced ====
==== Advanced ====
<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
programs.mpv = {
programs.mpv = {
Line 80: Line 86:


==== Where to get scripts ====
==== Where to get scripts ====
To find more scripts run this in a terminal: <syntaxhighlight lang="bash">
 
nix search nixpkgs mpvScripts
To find more scripts run this in a terminal: <syntaxhighlight lang="console">
</syntaxhighlight>The scripts are also defined in the following [https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/video/mpv/scripts Nixpkgs directory].
$ nix search nixpkgs mpvScripts
</syntaxhighlight>The scripts are also defined in the following [https://github.com/NixOS/nixpkgs/tree/master/pkgs/by-name/mp/mpv/scripts Nixpkgs directory].


==== Enabling additional features: where to find override options and using umpv ====
==== Enabling additional features: where to find override options and using umpv ====
The package override options are defined in the following [https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/video/mpv/default.nix Nixpkgs directory]. This includes a commonly used first party script called [https://github.com/mpv-player/mpv/blob/master/TOOLS/umpv umpv] which allows additional files to be appended to the playlist of an open instance. In the nix derivation of mpv, the umpv script is bundled into the program and can be ran from the command line with `umpv foo.ogg`. Note that umpv can only be ran with the name of the file being opened and cannot be ran with additional arguments or flags.
 
The package override options are defined in the following [https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/mp/mpv/package.nix Nixpkgs directory]. This includes a commonly used first party script called [https://github.com/mpv-player/mpv/blob/master/TOOLS/umpv umpv] which allows additional files to be appended to the playlist of an open instance. In the nix derivation of mpv, the umpv script is bundled into the program and can be ran from the command line with `umpv foo.ogg`. Note that umpv can only be ran with the name of the file being opened and cannot be ran with additional arguments or flags.


For example, here is an overlay showing how to enable JACK audio support:
For example, here is an overlay showing how to enable JACK audio support:


<syntaxhighlight>
<syntaxhighlight lang=nix>
nixpkgs.overlays = [
nixpkgs.overlays = [
   (final: prev: {
   (final: prev: {
Line 103: Line 111:
or alternatively, you can define the package inline:
or alternatively, you can define the package inline:


<syntaxhighlight>
<syntaxhighlight lang=nix>
(pkgs.mpv.override { mpv = pkgs.mpv-unwrapped.override { jackaudioSupport = true; }; })
(pkgs.mpv.override { mpv = pkgs.mpv-unwrapped.override { jackaudioSupport = true; }; })
</syntaxhighlight>
</syntaxhighlight>


Also note that commands cannot be passed to mpv using socat when mpv is ran using the umpv python wrapper. For example, if you try to pause umpv with <code>echo '{"command": ["cycle", "pause"]}' | socat - /tmp/mpvsocket</code>, it will result in an error similar to the following:
Also note that commands cannot be passed to mpv using socat when mpv is ran using the umpv python wrapper. For example, if you try to pause umpv with <code>echo '{"command": ["cycle", "pause"]}' | socat - /tmp/mpvsocket</code>, it will result in an error similar to the following:
<code>2025/05/07 22:49:15 socat[115919] E GOPEN: /tmp/mpvsocket: Connection refused</code>
<pre>2025/05/07 22:49:15 socat[115919] E GOPEN: /tmp/mpvsocket: Connection refused</pre>


== Troubleshooting ==
== Troubleshooting ==


==== Error, unknown format ====
==== Error, unknown format ====
If you get the following sort of error, note that MPV currently uses the small ffmpeg version (ffmpeg_5) instead of the full version (ffmpeg_5-full).  
If you get the following sort of error, note that MPV currently uses the small ffmpeg version (ffmpeg_5) instead of the full version (ffmpeg_5-full).  


<syntaxhighlight lang="shell">
<syntaxhighlight lang=console>
$ mpv --log-file=foo.log av://v4l2:/dev/video5
$ mpv --log-file=foo.log av://v4l2:/dev/video5
[lavf] Unknown lavf format v4l2
[lavf] Unknown lavf format v4l2
Line 125: Line 134:
To address this problem, you can use the following package configuration for ffmpeg.
To address this problem, you can use the following package configuration for ffmpeg.


<syntaxhighlight lang="nix">programs.mpv = {
<syntaxhighlight lang="nix">
programs.mpv = {
   enable = true;
   enable = true;