MPV: Difference between revisions

(4 intermediate revisions by 4 users not shown)

Line 1:

[https://mpv.io/ MPV] is an open-source command line media player ~~known for its high performance, versatility, and minimalist design~~.~~While it has a basic GUI, MPV can be paired with a GUI front-end like [[SMPlayer]] (package: smplayer) to offer a user-friendly interface similar to other desktop media players.~~

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

MPV supports a wide range of video and audio formats, ensuring extensive compatibility. It features advanced video rendering capabilities, including high-quality scaling algorithms, color management, and HDR support, which contribute to superior video playback quality. MPV leverages hardware-accelerated video decoding through APIs such as VA-API, VDPAU, and DXVA2, improving performance and reducing CPU usage. The player’s minimalist design emphasizes efficiency, offering a streamlined user experience with extensive configurability through command-line options and scripting interfaces.

== Installation ==

==== ~~2.1 Using~~ nix-shell ====

==== With nix-shell ====

nix-shell -p mpv

</syntaxhighlight>

==== ~~2.2 System-Wide Installation on~~ NixOS ====

==== With NixOS ====

environment.systemPackages = [

pkgs.mpv

];

~~</syntaxhighlight>After modifying your configuration, apply the changes by running:<syntaxhighlight lang="bash">~~

~~sudo nixos-rebuild switch~~

</syntaxhighlight>

==== With Home Manager ====

==== ~~2.3 User-Specific Installation with~~ Home Manager ====

home.packages = [

pkgs.mpv

];

~~</syntaxhighlight>After updating your configuration, apply the changes by running:<syntaxhighlight lang="bash">~~

~~home-manager switch~~

</syntaxhighlight>

== Configuration ==

== ~~Configuration~~ ==

=== With Home Manager ===

==== ~~3.1~~ Basic ====

==== Basic ====

programs.mpv ~~= {~~

programs.mpv.enable = true;

enable = true;

};

</syntaxhighlight>

==== ~~3.2~~ Advanced ====

==== Advanced ====

programs.mpv = {

Line 65:

Line 57:

== Tips and Tricks ==

==== ~~4.1~~ Where to get scripts ====

==== Where to get scripts ====

To find more scripts run this in a terminal: <syntaxhighlight lang="bash">

nix search nixpkgs mpvScripts

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

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

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

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

==== ~~5.1~~ 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).

Line 106:

Line 101:

# 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 known for its high performance, versatility, and minimalist design.While it has a basic GUI, MPV can be paired with a GUI front-end like [[SMPlayer]] (package: smplayer) to offer a user-friendly interface similar to other desktop media players.
+[https://mpv.io/ MPV] is an open-source command line media player.
-MPV supports a wide range of video and audio formats, ensuring extensive compatibility. It features advanced video rendering capabilities, including high-quality scaling algorithms, color management, and HDR support, which contribute to superior video playback quality. MPV leverages hardware-accelerated video decoding through APIs such as VA-API, VDPAU, and DXVA2, improving performance and reducing CPU usage. The player’s minimalist design emphasizes efficiency, offering a streamlined user experience with extensive configurability through command-line options and scripting interfaces.
 == Installation ==
-==== 2.1 Using nix-shell ====
+==== With nix-shell ====
 <syntaxhighlight lang="bash" start="3">
 nix-shell -p mpv
 </syntaxhighlight>
-==== 2.2 System-Wide Installation on NixOS ====
+==== With NixOS ====
 <syntaxhighlight lang="text">
 environment.systemPackages = [
   pkgs.mpv
 ];
-</syntaxhighlight>After modifying your configuration, apply the changes by running:<syntaxhighlight lang="bash">
-sudo nixos-rebuild switch
 </syntaxhighlight>
+==== With Home Manager ====
-==== 2.3 User-Specific Installation with Home Manager ====
 <syntaxhighlight lang="text">
 home.packages = [
    pkgs.mpv
 ];
-</syntaxhighlight>After updating your configuration, apply the changes by running:<syntaxhighlight lang="bash">
-home-manager switch
 </syntaxhighlight>
+== Configuration ==
-== Configuration ==
+=== With Home Manager ===
-==== 3.1 Basic ====
+==== Basic ====
 <syntaxhighlight lang="nix">
-programs.mpv = {
+programs.mpv.enable = true;
-    enable = true;
-};
 </syntaxhighlight>
-==== 3.2 Advanced ====
+==== Advanced ====
 <syntaxhighlight lang="nix">
 programs.mpv = {
@@ Line 65: / Line 57: @@
 == Tips and Tricks ==
-==== 4.1 Where to get scripts ====
+==== Where to get scripts ====
 To find more scripts run this in a terminal: <syntaxhighlight lang="bash">
 nix search nixpkgs mpvScripts
 </syntaxhighlight>The scripts are also defined in the following [https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/video/mpv/scripts Nixpkgs directory].
-==== 4.2 Where to find override options ====
+==== 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.
+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 ==
-==== 5.1 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).
@@ Line 106: / Line 101: @@
 # 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]]