Difference between revisions of "Package:Mpv"
(For a more out-of-the-box solution, several alternatives exist) |
|||
| (4 intermediate revisions by one other user not shown) | |||
| Line 2: | Line 2: | ||
|Summary=Video player based on MPlayer/mplayer2. | |Summary=Video player based on MPlayer/mplayer2. | ||
|CatPkg=media-video/mpv | |CatPkg=media-video/mpv | ||
|Maintainer=Oleg | |Maintainer=Oleg | ||
|Homepage=http://mpv.io/ | |Homepage=http://mpv.io/ | ||
}} | }} | ||
mpv is a fork of mplayer2, | 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== | ==Installation== | ||
<console> | <console> | ||
###i## | ###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> | </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]. | ||
mpv | |||
{{File|name=~/.mpv/ | ===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 the video position on quit | ||
save-position-on-quit | save-position-on-quit | ||
| Line 25: | Line 47: | ||
vo=opengl | vo=opengl | ||
}} | }} | ||
All possible options are listed in the man page: | |||
<console> | <console> | ||
###i## man mpv | ###i## man mpv | ||
</console> | </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: | 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=~/.mpv/input.conf|body= | {{File|name=~/.config/mpv/input.conf|body= | ||
n playlist_next | n playlist_next | ||
p playlist_prev | p playlist_prev | ||
}} | }} | ||
The man page provides information about all possible bindings. | 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}} | {{EbuildFooter}} | ||
Latest revision as of 11:38, January 9, 2023
Mpv
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]