MPV: Difference between revisions
m
Removed numbering
(shorten mpv override flags, merge "mpv scripts" section into configuration section) |
m (Removed numbering) |
||
(3 intermediate revisions by 3 users not shown) | |||
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. | [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. | ||
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 | 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 == | == Installation == | ||
=== Using | ==== Using nix-shell ==== | ||
<syntaxhighlight lang="bash" start="3"> | |||
nix-shell -p mpv | nix-shell -p mpv | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== System-Wide Installation on NixOS === | ==== System-Wide Installation on NixOS ==== | ||
<syntaxhighlight lang="text"> | |||
environment.systemPackages = [ | environment.systemPackages = [ | ||
pkgs.mpv | |||
]; | ]; | ||
</syntaxhighlight>After modifying your configuration, apply the changes by running:<syntaxhighlight lang=" | </syntaxhighlight>After modifying your configuration, apply the changes by running:<syntaxhighlight lang="bash"> | ||
sudo nixos-rebuild switch | sudo nixos-rebuild switch | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== User-Specific Installation with Home Manager === | ==== User-Specific Installation with Home Manager ==== | ||
<syntaxhighlight lang="text"> | |||
home.packages = [ | home.packages = [ | ||
pkgs.mpv | pkgs.mpv | ||
]; | ]; | ||
</syntaxhighlight>After updating your configuration, apply the changes by running:<syntaxhighlight lang=" | </syntaxhighlight>After updating your configuration, apply the changes by running:<syntaxhighlight lang="bash"> | ||
home-manager switch | home-manager switch | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Configuration == | == Configuration == | ||
==== Basic ==== | |||
<syntaxhighlight lang="nix"> | |||
programs.mpv = { | programs.mpv = { | ||
enable = true; | enable = true; | ||
}; | }; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==== Advanced ==== | |||
<syntaxhighlight lang="nix"> | |||
programs.mpv = { | programs.mpv = { | ||
enable = true; | enable = true; | ||
package = ( | |||
package = | pkgs.mpv-unwrapped.wrapper { | ||
scripts = with pkgs.mpvScripts; [ | |||
uosc | |||
sponsorblock | |||
]; | |||
mpv = pkgs.mpv-unwrapped.override { | mpv = pkgs.mpv-unwrapped.override { | ||
waylandSupport = true; | waylandSupport = true; | ||
}; | }; | ||
}) | } | ||
); | |||
config = { | config = { | ||
profile = "high-quality"; | profile = "high-quality"; | ||
Line 62: | Line 63: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == Tips and Tricks == | ||
==== 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]. | |||
==== Where to find override options ==== | |||
The package override options are defined in the following [https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/video/mpv/default.nix Nixpkgs directory]. | |||
== Troubleshooting == | |||
If you get the following sort of error, note that | ==== 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). | |||
<syntaxhighlight lang="shell"> | <syntaxhighlight lang="shell"> | ||
Line 80: | Line 92: | ||
enable = true; | enable = true; | ||
package = | package = ( | ||
pkgs.mpv-unwrapped.wrapper { | |||
mpv = pkgs.mpv-unwrapped.override { | mpv = pkgs.mpv-unwrapped.override { | ||
ffmpeg = pkgs.ffmpeg-full; | ffmpeg = pkgs.ffmpeg-full; | ||
}; | }; | ||
}); | } | ||
); | |||
}; | }; | ||
</syntaxhighlight> | </syntaxhighlight> |