mpv の設定ガイド

2025-07-15

mpv の特徴

mpv は自由に使えるメディアプレーヤーで、次の特徴がある。

高品質なビデオ出力（OpenGL, Vulkan）
GPUによるビデオデコード
マウスを動かすと小さなコントローラーが出る（消すこともできる）
活発に開発中

基本設定

アップスケーラーをインストール

RAVU をインストール。
RAVU は Google の画像超解像技術からヒントを得たアップスケーラー。
DVD動画をFHDモニターで表示したり、FHD動画を4Kモニターで表示する場合に効果がある。
FHD動画をFHDモニターで表示する場合は、1倍表示なので効果はほとんどない。

# https://github.com/bjin/mpv-prescalers/
wget https://github.com/bjin/mpv-prescalers/archive/refs/heads/master.zip
unzip -q master.zip
mkdir -p ~/.config/mpv/shaders
# gather ディレクトリのものが高速版
mv mpv-prescalers-master/gather/ravu-lite-r*.hook ~/.config/mpv/shaders/

mpv.conf を設定

mousepad ~/.config/mpv/mpv.conf

次の行を追加。

vo=gpu-next
gpu-api=vulkan
hwdec=auto-safe
profile=high-quality

ao=pipewire

# 音声のみのファイルでもウィンドウを表示
force-window=yes

# 常にウィンドウを最大化
window-maximized=yes

# コンソールへのメッセージ出力を減らす
quiet=yes

# デフォルトのアップスケーラーを指定
glsl-shaders=\"~~/shaders/ravu-lite-r2.hook\"

モニターに超解像技術が搭載されている場合

モニターに超解像技術が搭載されている場合はオフにする。アップスケーラーの効果が分かりづらくなるので。
REGZA をモニターとして使用している場合は、
「低遅延モード: オン」「レゾリューションプラス: オフ」
「ヒストグラムバックライト制御: オン」「質感リアライザー: オート」にする。
質感リアライザーをオフにすると、全体の色味が白っぽくなる。

その他のアップスケーラー

NVScaler

NVIDIA Image Scaling。Radeonでも使用できる。

# https://gist.github.com/agyild
wget https://gist.github.com/agyild/7e8951915b2bf24526a9343d951db214/raw/05f00864228871ffd157daa9beb2db8fa7412cfa/NVScaler.glsl
mkdir -p ~/.config/mpv/shaders
mv NVScaler.glsl ~/.config/mpv/shaders/

FSR

AMD FidelityFX Super Resolution

# https://gist.github.com/agyild
wget https://gist.github.com/agyild/82219c545228d70c5604f865ce0b0ce5/raw/2623d743b9c23f500ba086f05b385dcb1557e15d/FSR.glsl
mkdir -p ~/.config/mpv/shaders
mv FSR.glsl ~/.config/mpv/shaders/

SGSR

Qualcomm Snapdragon Game Super Resolution (GSR) v1

# https://gist.github.com/agyild
wget https://gist.githubusercontent.com/agyild/7715b6b1f38427839d58f80884902cab/raw/3255192a8d49af76bf41e9b40fdbcc5f9d9450da/SGSR.glsl
mkdir -p ~/.config/mpv/shaders
mv SGSR.glsl ~/.config/mpv/shaders/

Anime4K

アニメの4K化に特化したアップスケーラー。
「Mode A」は1080pアニメの4K化、「Mode B」は720pアニメの4K化、「Mode C」は480pアニメの4K化に最適化されている。

# https://github.com/bloc97/Anime4K/blob/master/md/GLSL_Instructions_Linux.md
wget https://github.com/Tama47/Anime4K/releases/download/v4.0.1/GLSL_Mac_Linux_Low-end.zip
unzip -q GLSL_Mac_Linux_Low-end.zip
mkdir -p ~/.config/mpv/shaders
mv shaders/*.glsl ~/.config/mpv/shaders/

FSRCNNX

高速超解像畳み込みニューラルネットワークによるアップスケーラー。

# https://github.com/igv/FSRCNN-TensorFlow/releases
wget https://github.com/igv/FSRCNN-TensorFlow/releases/download/1.1/FSRCNNX_x2_16-0-4-1.glsl
wget https://github.com/igv/FSRCNN-TensorFlow/releases/download/1.1/FSRCNNX_x2_8-0-4-1.glsl
mkdir -p ~/.config/mpv/shaders
mv FSRCNNX_x2_*.glsl ~/.config/mpv/shaders/

ArtCNN

アニメコンテンツに最適化されたアップスケーラー。
ファイル名に「_DS」が付くものは、ノイズ除去とシャープ化を追加で行う。これはほとんどのウェブ動画で役に立つ。

# https://github.com/Artoriuz/ArtCNN
wget https://github.com/Artoriuz/ArtCNN/raw/refs/heads/main/GLSL/ArtCNN_C4F16_DS.glsl
wget https://github.com/Artoriuz/ArtCNN/raw/refs/heads/main/GLSL/ArtCNN_C4F32_DS.glsl
mkdir -p ~/.config/mpv/shaders
mv *_DS.glsl ~/.config/mpv/shaders/

アップスケーラーの効果を比較

アップスケーラーにショートカットキーを割り当てる

mousepad ~/.config/mpv/input.conf

次の行を追加。

# シェーダーを切り替える
CTRL+1 no-osd change-list glsl-shaders set "~~/shaders/ravu-lite-r2.hook"; show-text "ravu-lite-r2.hook"

CTRL+2 no-osd change-list glsl-shaders set "~~/shaders/NVScaler.glsl"; show-text "NVScaler.glsl"

CTRL+3 no-osd change-list glsl-shaders set "~~/shaders/FSR.glsl"; show-text "FSR.glsl"

CTRL+4 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Clamp_Highlights.glsl:~~/shaders/Anime4K_Upscale_Denoise_CNN_x2_M.glsl:~~/shaders/Anime4K_AutoDownscalePre_x2.glsl:~~/shaders/Anime4K_AutoDownscalePre_x4.glsl:~~/shaders/Anime4K_Upscale_CNN_x2_S.glsl"; show-text "Anime4K: Mode C (Fast)"

CTRL+5 no-osd change-list glsl-shaders set "~~/shaders/FSRCNNX_x2_8-0-4-1.glsl"; show-text "FSRCNNX_x2_8-0-4-1.glsl"

CTRL+6 no-osd change-list glsl-shaders set "~~/shaders/ArtCNN_C4F16_DS.glsl"; show-text "ArtCNN_C4F16_DS.glsl"

CTRL+7 no-osd change-list glsl-shaders set "~~/shaders/ArtCNN_C4F32_DS.glsl"; show-text "ArtCNN_C4F32_DS.glsl"

CTRL+8 no-osd change-list glsl-shaders set "~~/shaders/SGSR.glsl"; show-text "SGSR.glsl"

CTRL+0 no-osd change-list glsl-shaders clr ""; show-text "GLSL shaders cleared"

静止画で効果を比較

480p の動画をアップスケールして効果を比較。

# YouTube の画質指定には yt-dlp が必要
yay -S --needed yt-dlp

mpv --ytdl-format=244+251 https://www.youtube.com/watch?v=ue4irL_g-UE --start=00:04:38 --fs --pause

「Ctrl」を押したまま「0」「1」「2」と順に押し、アップスケーラーの効果を比較。
網目のような細かい模様が映っていると、効果を比較しやすい。

コマ落ちしないか確認

480p の動画をアップスケールしてコマ落ちしないか確認。

mpv --ytdl-format=244+251 https://www.youtube.com/watch?v=ue4irL_g-UE --fs

「Shift+I」を押して情報画面を表示。
「Dropped Frames」の値が増えないか確認。
内蔵GPUだと「ArtCNN_C4F32_DS.glsl」（Ctrl+7）がコマ落ちするかもしれない。

参考: アップスケーラーの画質を数値で比較

アップスケーラーの画質比較はこちら。
画質の良し悪しは主観に左右されるので、数値がすべてではない。

ショートカットキーを変更

mousepad ~/.config/mpv/input.conf

次の行を追加。

# 右クリックによる一時停止を無効にする
MBTN_RIGHT ignore

# マウスホイールによる音量操作を無効にする
WHEEL_UP ignore
WHEEL_DOWN ignore
WHEEL_LEFT ignore
WHEEL_RIGHT ignore

# PageUp/PageDown で10分移動
PGUP seek 600
PGDWN seek -600

# Shift + PageUp/PageDown でチャプター移動
Shift+PGUP add chapter 1
Shift+PGDWN add chapter -1

# Enter/Esc で終了
ENTER quit
ESC quit

右下の時間表示を「残り時間」から「全体の時間」に変更

mousepad ~/.config/mpv/script-opts/osc.conf

次の行を追加。

timetotal=yes

HOME