Latest revision as of 11:38, January 9, 2023

Mpv

Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

mpv is a simple and lightweight media player for video and audio. As a fork of mplayer2, it shares some features while introducing others. To learn more about the differences take a look at their docs.

Due to it's high flexibility and configurability, mpv is great for media center usage, lightweight systems or just users who know what they want in a media player. For a more out-of-the-box solution, several alternatives like media-video/vlc or media-video/totem are recommended.

Installation

root # emerge media-video/mpv

Usage

mpv does not ship with a graphical user interface (besides the video display). The easiest way to play a video is:

root # mpv /path/to/video/file

Since this is not very comfortable, you can of course set mpv as the default application for video playback. Depending on your environment you can use either the configuration tools provided by your desktop environment/file manager; for more info, see [1].

Controls

Because there are no gui elements, keyboard shortcuts are used to control mpv. The following table provides the most important one; check the manpage (man mpv) for more.

Command	Shortcut
Play/Pause	Space or p
Increase/Decrease volume	/ and * or 9 and 0
Quit	q
Cycle through the available audio tracks	#
Show OSD	o

You may change all of these bindings (and more) to your custom using the config file.

Configuration

Even though mpv works fine without a config file, the configuration options allow to adjust a lot of settings. A short example is provided below:

~/.config/mpv/mpv.conf

# Save the video position on quit
save-position-on-quit

# Use the vdpau driver for hardware decoding (for nvidia cards)
hwdec=vdpau

# Video output driver. A list can be displayed via: mpv -vo=help
vo=opengl

All possible options are listed in the man page:

root #  man mpv

Keybindings

You may create a separate file called input.conf for customizing the shortcuts for mpv. The example below binds the key "n" to skip to the next video in the current playlist and the key "p" to skip to the previous video:

~/.config/mpv/input.conf

n playlist_next
p playlist_prev

The man page provides information about all possible bindings.

Twitch/Youtube playback

mpv is capable of playing twitch.tv/youtube streams and videos. To enable this, install No results and enable the lua useflag on media-video/mpv.

root # echo "media-video/mpv lua" >> /etc/portage/package.use
root # emerge -a net-misc/youtube-dl media-video/mpv

After everything is set up, use the --ytdl parameter for youtube and twitch playback:

root # mpv --ytdl [url]

@@ Line 2: / Line 2: @@
 |Summary=Video player based on MPlayer/mplayer2.
 |CatPkg=media-video/mpv
-|Maintainer=
+|Maintainer=Oleg
 |Homepage=http://mpv.io/
 }}
-mpv is a fork of mplayer2, to learn more about the differences take a look at their [https://github.com/mpv-player/mpv/blob/master/DOCS/man/changes.rst docs].
+mpv is a simple and lightweight media player for video and audio. As a fork of mplayer2, it shares some features while introducing others. To learn more about the differences take a look at their [https://github.com/mpv-player/mpv/blob/master/DOCS/man/changes.rst docs].
-Currently there is only mpv version 0.3.11 availabe in Funtoo, higher versions have been masked because they require a masked version of libav.
+Due to it's high flexibility and configurability, mpv is great for media center usage, lightweight systems or just users who know what they want in a media player. For a more out-of-the-box solution, several alternatives like {{c|media-video/vlc}} or {{c|media-video/totem}} are recommended.
-{{fancynote|Read the [https://github.com/mpv-player/mpv/wiki/FFmpeg-versus-Libav mpv wiki] to unstand ffmpeg vs libav especially in regard to mpv.
-If you are interested you  might even read the article [http://blog.pkh.me/p/13-the-ffmpeg-libav-situation.html The FFmpeg/Libav situation] }}
-However if you use media-video/ffmpeg you can safely unmask it for virtual/ffmpeg
+==Installation==
-{{fancyimportant|To learn more about unmasking packages, and making sure you really want to do this, take a look at the [http://wiki.gentoo.org/wiki/Knowledge_Base:Unmasking_a_package article on the Gentoo wiki]. }}
+<console>
+###i## emerge media-video/mpv
+</console>
+==Usage==
+mpv does not ship with a graphical user interface (besides the video display). The easiest way to play a video is:
+<console>
+###i## mpv /path/to/video/file
+</console>
+Since this is not very comfortable, you can of course set mpv as the default application for video playback. Depending on your environment you can use either the configuration tools provided by your desktop environment/file manager; for more info, see [https://wiki.archlinux.org/index.php/Default_applications].
+===Controls===
+Because there are no gui elements, keyboard shortcuts are used to control mpv. The following table provides the most important one; check the manpage ({{c|man mpv}}) for more.
+{{TableStart}}
+<tr class="info"><th>Command</th><th>Shortcut</th></tr>
+<tr><td>Play/Pause</td><td>Space or p</td></tr>
+<tr><td>Increase/Decrease volume</td><td>/ and * or 9 and 0</td></tr>
+<tr><td>Quit</td><td>q</td></tr>
+<tr><td>Cycle through the available audio tracks</td><td>#</td></tr>
+<tr><td>Show OSD</td><td>o</td></tr>
+{{TableEnd}}
+You may change all of these bindings (and more) to your custom using the config file.
+==Configuration==
+Even though mpv works fine without a config file, the configuration options allow to adjust a lot of settings.
+A short example is provided below:
+{{File|name=~/.config/mpv/mpv.conf|body=
+# Save the video position on quit
+save-position-on-quit
+# Use the vdpau driver for hardware decoding (for nvidia cards)
+hwdec=vdpau
+# Video output driver. A list can be displayed via: mpv -vo=help
+vo=opengl
+}}
+All possible options are listed in the man page:
+<console>
+###i##  man mpv
+</console>
+===Keybindings===
+You may create a separate file called ''input.conf'' for customizing the shortcuts for mpv. The example below binds the key "n" to skip to the next video in the current playlist and the key "p" to skip to the previous video:
+{{File|name=~/.config/mpv/input.conf|body=
+n playlist_next
+p playlist_prev
+}}
+The man page provides information about all possible bindings.
+==Twitch/Youtube playback==
+mpv is capable of playing ''twitch.tv''/''youtube'' streams and videos. To enable this, install {{Package|net-misc/youtube-dl}} and enable the ''lua'' useflag on media-video/mpv.
+<console>
+###i## echo "media-video/mpv lua" >> /etc/portage/package.use
+###i## emerge -a net-misc/youtube-dl media-video/mpv
+</console>
+After everything is set up, use the ''--ytdl'' parameter for youtube and twitch playback:
 <console>
-emerge --ask --autounmask-write =media-video/mpv-0.4.2
+###i## mpv --ytdl [url]
-dispatch-conf
-emerge --ask =media-video/mpv-0.4.2
 </console>
 {{EbuildFooter}}

Difference between revisions of "Package:Mpv"