mpv
mpv はフリーでオープンソースなコマンドラインメディアプレイヤーです。mplayer2 をベースとしており、さらに遡ればオリジナルの MPlayer をベースとしています。派生元との類似点は多いものの、全体としては mpv は完全に異なるプログラムとして扱われるべきです。
インストール
USE フラグ
デフォルトの USE 設定は以下のコア機能を提供します: CLI プレイヤー、Xorg サポート、音声と動画の再生、オンスクリーンディスプレイ (OSD) とオンスクリーンコントローラ (OSC)、そして Lua スクリプティングインターフェースです。
通常はハードウェア動画デコード機能も欲しいでしょう。mpv は VAAPI と VDPAU ハードウェアデコード API の両方を、それぞれ vaapi および vdpau USE フラグを介してサポートしています。システムで利用できる API を手動で有効にする必要があります。mpv はまた、nvenc USE フラグを介して NVDEC ハードウェアデコード API もサポートしています (プロプライエタリな nvidia-drivers が必要です)。
機能の完全な一覧については、下の USE フラグの一覧を参照してください。
USE flags for media-video/mpv Media player for the command line
+X
|
Add support for X11 |
+alsa
|
Add support for media-libs/alsa-lib (Advanced Linux Sound Architecture) |
+cli
|
Enable the command-line player |
+drm
|
Enable Kernel Mode Setting / Direct Rendering Manager based video outputs |
+egl
|
Enable EGL (Embedded-System Graphics Library, interfacing between windowing system and OpenGL/GLES) support |
+iconv
|
Enable support for the iconv character set conversion library |
+libmpv
|
Enable the shared library and headers (used by frontends / plugins) |
+lua
|
Enable Lua scripting, OSC (On Screen Controller) GUI, and net-misc/yt-dlp support |
+uchardet
|
Enable subtitles charset discovery via app-i18n/uchardet |
+vulkan
|
Add support for 3D graphics and computing via the Vulkan cross-platform API |
aqua
|
Include support for the Mac OS X Aqua (Carbon/Cocoa) GUI |
archive
|
Enable support for various archive formats via app-arch/libarchive |
bluray
|
Enable playback of Blu-ray filesystems |
cdda
|
Add Compact Disk Digital Audio (Standard Audio CD) support |
coreaudio
|
Build the CoreAudio driver on Mac OS X systems |
debug
|
Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces |
dvb
|
Add support for DVB (Digital Video Broadcasting) |
dvd
|
Add support for DVDs |
gamepad
|
Enable gamepad input support |
jack
|
Add support for the JACK Audio Connection Kit |
javascript
|
Enable javascript support |
jpeg
|
Add JPEG image support |
lcms
|
Add lcms support (color management engine) |
libcaca
|
Add support for colored ASCII-art graphics |
nvenc
|
Add support for NVIDIA Encoder/Decoder (NVENC/NVDEC) API for hardware accelerated encoding and decoding on NVIDIA cards (requires x11-drivers/nvidia-drivers) |
openal
|
Add support for the Open Audio Library |
opengl
|
Enable support for OpenGL-based video backends (Note: deprecated for X11, USE=egl provides the newer support for -gpu-api=opengl) |
pipewire
|
Enable sound support via native PipeWire backend |
pulseaudio
|
Add sound server support via media-libs/libpulse (may be PulseAudio or PipeWire) |
rubberband
|
Enable high quality pitch correction via media-libs/rubberband |
sdl
|
Enable media-libs/libsdl2 based video and audio outputs (Note: these outputs exist for compatibility reasons only, avoid if possible) |
selinux
|
!!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur |
sixel
|
Enable support for the sixel video backend using media-libs/libsixel |
sndio
|
Enable sound support via media-sound/sndio |
soc
|
Use additional media-video/ffmpeg patches for efficient playback on some SoCs (e.g. ARM, RISC-V) |
test
|
Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently) |
tools
|
Install extra tools: mpv_identify.sh, mpv_idet.sh, and umpv |
vaapi
|
Enable Video Acceleration API for hardware decoding |
vdpau
|
Enable the Video Decode and Presentation API for Unix acceleration interface |
wayland
|
Enable dev-libs/wayland backend |
xv
|
Add in optional support for the Xvideo extension (an X API for video playback) |
zimg
|
Enable libzimg support (for vf_fingerprint) |
zlib
|
Add support for zlib compression |
Emerge
root #emerge --ask media-video/mpv追加のソフトウェア
YouTube や他の人気のあるストリーミングウェブサイトの URL を直接再生するには、net-misc/yt-dlp をインストールしてください:
root #emerge --ask net-misc/yt-dlpGTK GUI フロントエンドのためには media-video/celluloid をインストールしてください:
root #emerge --ask media-video/celluloid設定
mpv は通常は設定を必要としません。しかしながら、デフォルトの挙動の多くの側面を変更することができます。 設定のうち最重要な 2 つの部分は、プレイヤーの設定とキーバインディングです。どちらについても以下で簡単に説明します。
プレイヤー設定
プレイヤー設定は、~/.config/mpv/mpv.conf ファイルに option=value 構文を使用して置くべきです。 # の後ろにあるものはすべてコメントとみなされます。
ほとんどすべてのコマンドラインオプションは、プレイヤー設定として設定することができます。多くの場合、--option=value コマンドライン引数と等価な設定は option=value になります。値なしで動作するオプションは、yes に設定することで有効化でき、no に設定することで無効化できます。
異なる設定を簡単に使い分けるために、設定ファイルでプロファイルを定義することができます。プロファイルは [my-profile] のように、角括弧で囲まれた名前で始まります。それに続くオプションはすべて、このプロファイルの一部となります。プロファイルの定義を終了するには、別のプロファイルを開始するか、以降を通常のオプションとするためにプロファイル名 default を使用してください。
利用可能なオプションの完全な一覧は、マニュアルを参照してください。
~/.config/mpv/mpv.confプレーヤー設定例# シークを常に (例えば HTTP ストリームのローカルキャッシュ内でも) 許可する
force-seekable=yes
# 動画が無い場合でも常に動画ウィンドウを開く
force-window=yes
# プレイリストの終わりに到達したときに終了しない
keep-open=yes
# 終了時に現在の再生位置を常に保存する
save-position-on-quit=yes
# 'high-quality' プロファイルを作成する
[high-quality]
# このプロファイルの説明
profile-desc="High quality rendering"
# デフォルトの 'opengl-hq' プロファイルからすべての設定を取り込む
profile=opengl-hq
# より良いパフォーマンスのためにバンディング低減を無効化する
deband=no
キーバインディング
キーバインディングは、~/.config/mpv/input.conf ファイルに key command 構文を使用して置くべきです。 # の後ろにあるものはすべてコメントとみなされます。
利用可能なコマンドの完全な一覧は、マニュアルを参照してください。
~/.config/mpv/input.confキーバインディング例# Ctrl+q でプレーヤーを閉じる
Ctrl+q quit
# D で現在のファイルをプレイリストから削除する
D playlist-remove current
# R で現在のプレイリストをシャッフルする
R playlist-shuffle
例
mpv のコントリビュータたちの、高度な実世界での設定です: [1]、[2]。
使い方
ユーザスクリプトとプラグイン
mpv のコア機能は、Lua または JavaScript のスクリプトか、C プラグインを使って、拡張することができます。
~/.config/mpv/scripts/ ディレクトリのすべてのスクリプトとプラグインは自動的にロードされます。あるいは --script=/path/to/your/script.file のようにして、コマンドラインから手動でスクリプトまたはプラグインをロードすることもできます。
複数の Lua スクリプトが mpv に付属しており、これらは /usr/share/mpv/lua/ ディレクトリにインストールされます。上流の wiki にもサードパーティ製スクリプトおよびプラグインの膨大なリストがあります。
トラブルシューティング
mpv に関する問題がある場合は、
--log-file オプションでファイルへのログ出力を有効化するか、-v オプションで詳細な端末出力を有効化してください。FFmpeg/Libav/libass 等の更新後に映像が乱れる、またはクラッシュする
TLDR: Gentoo のバグとして報告した後、mpv を再ビルドしてください。
FFmpeg/Libav/libass はいずれも、マイナーリリース間でときどき ABI 非互換な破壊的変更を導入することで知られています。 通常これらのライブラリのスロットはマイナーリリース間で変化せず、そのため自動的な mpv の再ビルドが発生しません。 このことが、これらのライブラリの以前のバージョン向けにコンパイルされた mpv に問題を引き起こします。問題は機能の部分的な障害から、突然のクラッシュまで多岐にわたります。
こうした事例に対する上流の回答は「他のプログラムが適切な ABI 互換性を維持できないのは私たちの問題ではない。mpv を再ビルドしてください」といった感じです。まずは発生している障害をメンテナに通知するために Gentoo バグを報告し、mpv を再ビルドしてください。
"mpv was compiled against a different version of FFmpeg..." メッセージ
mpv に何の問題もなければ、このメッセージは無視してください。そうでない場合は、これらの指示に従ってください。
ハードウェア動画デコーディングの障害/高い CPU 使用率
ハードウェアデコーディングに関する問題が無いか mpv ログを確認してください。動画再生中に CPU 使用率が高くなるのは、ハードウェアデコーディングに障害がある兆候です。
まず、ハードウェアが必要な動画コーデックに対応しているか確認してください。GPU が VAAPI および VDPAU デコーディング API を利用して対応しているコーデックの一覧は、それぞれ vainfo および vdpauinfo コマンドを利用して確認できます。再生した動画ファイルで使用されているコーデックは mpv ログ内で確認できます。GPU が必要なコーデックに対応しているが、mpv がハードウェアデコーディングを行っていない場合は、--hwdec-codecs=all オプションを試してみてください。
次に、ツリーで利用可能な非 live (9999 以外) で最新のバージョンの mpv を使用していることを確認してください。 最新バージョンへの更新で問題が解決する場合は、Gentoo のバグとして報告してください。
それでも解決しない場合、いくつか試してみることがあります:
--hwdec=auto-copyで、コピーバックを利用したハードウェアデコーダを有効化してください。- VAAPI のみ:
--vo=vaapiを--hwdec=vaapiまたは--hwdec=vaapi-copyとともに利用して、vaapi の出力を使用してください。 - VDPAU のみ:
--vo=vdpauを--hwdec=vdpauまたは--hwdec=vdpau-copyとともに利用して、vdpau の出力を使用してください。 - VDPAU のみ:
--opengl-backend=x11で、opengl の出力のために X11/GLX バックエンドを使用してください。 - Intel GPU のみ: x11-base/xorg-server に含まれる modesetting Xorg ドライバを使用してください。
--opengl-dumb-mode=yesで、opengl 出力のために dumb-mode を有効化してください。--vo=xvを--hwdec=auto-copyとともに利用して、xv 出力を使用してください。
テアリング
テアリングは、表示時にオブジェクトが正しく水平に並ばない、動画再生時の欠陥です。 上流の FAQ を参照してください。
Quote from upstream: "Libav is basically unsupported by mpv, except it still sort of compiles and many things work" [3]. Patches are welcome for any issues regarding Libav.
更新メモ
Upstream maintains a list of user-visible changes. The most important ones are discussed below.
Volume in 0.18.1
Since version 0.18.1 the software volume control is always enabled. This means that volume controls don't change the system volume, e.g. per-application volume with PulseAudio.
If you want to restore the previous behaviour, define the following key bindings:
~/.config/mpv/input.confMOUSE_BTN5 add ao-volume -2
MOUSE_BTN6 add ao-volume +2
9 add ao-volume -2
0 add ao-volume +2
/ add ao-volume -2
* add ao-volume +2
m cycle ao-mute
VOLUME_DOWN add ao-volume -2
VOLUME_UP add ao-volume +2
MUTE cycle ao-mute
This covers only default volume key bindings as of version 0.18.0.
OSC in 0.21.0
In version 0.21.0 the default OSC layout was changed to bottombar.
If you want to restore the previous layout, add the following OSC settings:
~/.config/mpv/lua-settings/osc.conflayout=box
seekbarstyle=slider
deadzonesize=0
minmousemove=3
This covers only the default OSC layout as of version 0.20.0.
Deprecated VO/AO sub-options in 0.21.0
In version 0.21.0 all VO/AO sub-options were deprecated and replaced by options.
If you've been using those, refer to this replacement list.
Subtitles with .txt extension in 0.24.0
Since version 0.24.0 subtitles with .txt extension are no longer recognized as subtitles and thus no longer autoloaded. Please refer to the offending commit's message and this upstream issue for more info.
If you want to restore the previous behavior, use the following Lua script: autoloadtxt.lua.
Deprecated audio/video filters in 0.25.0
In version 0.25.0 many builtin audio and video filters were deprecated.
関連項目
- SDDM — X server と Wayland プロトコルの両方をサポートする現代的なディスプレイマネージャです。
- XDM