MPV: Difference between revisions

(7 intermediate revisions by 4 users not shown)

Line 1:

[https://mpv.io/ ~~MPV~~] is an open-source command line media player.

{{Infobox application

| name = mpv

| type = CLI

| image = Unofficial_Mpv_logo_(with_gradients).svg

| website = [https://mpv.io/ mpv.io]

| documentation = [https://mpv.io/manual/ mpv Manual]

| bugTracker = [https://github.com/mpv-player/mpv/issues GitHub Issues]

| github = mpv-player/mpv

| latestRelease = 0.40.0; 11 June 2025

| os = Linux, macOS, Windows

| programmingLanguage = C

| initialRelease = 7 August 2023

}}

'''mpv''' is an open-source command line media player.

== Installation ==

Line 62:

Line 77:

</syntaxhighlight>The scripts are also defined in the following [https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/video/mpv/scripts Nixpkgs directory].

==== ~~Where~~ to find override options ====

==== 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].

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.

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

nixpkgs.overlays = [

(final: prev: {

mpv = prev.mpv.override {

mpv = prev.mpv-unwrapped.override {

jackaudioSupport = true;

};

})

];

</syntaxhighlight>

or alternatively, you can define the package inline:

(pkgs.mpv.override { mpv = pkgs.mpv-unwrapped.override { jackaudioSupport = true; }; })

</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:

<code>2025/05/07 22:49:15 socat[115919] E GOPEN: /tmp/mpvsocket: Connection refused</code>

== Troubleshooting ==

Line 98:

Line 136:

# https://github.com/mpv-player/mpv/wiki

# https://en.wikipedia.org/wiki/Mpv_(media_player)

# https://~~mynixos~~.com/~~search~~?q=mpv

# https://search.nixos.org/packages?query=mpv

# https://home-manager-options.extranix.com/?query=mpv

[[Category:Applications]]

[[Category:CLI Applications]]

[[Category:Media Player]]

@@ Line 1: / Line 1: @@
-[https://mpv.io/ MPV] is an open-source command line media player.
+{{DISPLAYTITLE:mpv}}
+{{Infobox application
+| name = mpv
+| type = CLI
+| image = Unofficial_Mpv_logo_(with_gradients).svg
+| website = [https://mpv.io/ mpv.io]
+| documentation = [https://mpv.io/manual/ mpv Manual]
+| bugTracker = [https://github.com/mpv-player/mpv/issues GitHub Issues]
+| github = mpv-player/mpv
+| latestRelease = 0.40.0; 11 June 2025
+| os = Linux, macOS, Windows
+| programmingLanguage = C
+| initialRelease = 7 August 2023
+}}
+'''mpv''' is an open-source command line media player.
 == Installation ==
@@ Line 62: / Line 77: @@
 </syntaxhighlight>The scripts are also defined in the following [https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/video/mpv/scripts Nixpkgs directory].
-==== Where to find override options ====
+==== 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].
+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.
+For example, here is an overlay showing how to enable JACK audio support:
+<syntaxhighlight>
+nixpkgs.overlays = [
+  (final: prev: {
+    mpv = prev.mpv.override {
+      mpv = prev.mpv-unwrapped.override {
+        jackaudioSupport = true;
+      };
+    };
+  })
+];
+</syntaxhighlight>
+or alternatively, you can define the package inline:
+<syntaxhighlight>
+(pkgs.mpv.override { mpv = pkgs.mpv-unwrapped.override { jackaudioSupport = true; }; })
+</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:
+ <code>2025/05/07 22:49:15 socat[115919] E GOPEN: /tmp/mpvsocket: Connection refused</code>
 == Troubleshooting ==
@@ Line 98: / Line 136: @@
 # https://github.com/mpv-player/mpv/wiki
 # https://en.wikipedia.org/wiki/Mpv_(media_player)
-# https://mynixos.com/search?q=mpv
+# https://search.nixos.org/packages?query=mpv
+# https://home-manager-options.extranix.com/?query=mpv
 [[Category:Applications]]
 [[Category:CLI Applications]]
 [[Category:Media Player]]