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 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].
+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.
+==Installation==
+<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>
+###i## mpv --ytdl [url]
+</console>
 {{EbuildFooter}}

Difference between revisions of "Package:Mpv"