mpv の設定

mpv の特徴

mpv はフリーのメディアプレーヤーで、次の特徴がある。

• 高品質なビデオ出力（OpenGL, Vulkan）
• ビデオのハードウェアデコード
• オンスクリーンコントローラー（マウスを動かすと表示される）
• 活発に開発中

基本設定

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

# RAVU
# Google の超解像技術から着想を得たアップスケーラー。
# https://github.com/bjin/mpv-prescalers
wget https://raw.githubusercontent.com/bjin/mpv-prescalers/refs/heads/master/compute/ravu-lite-r3.hook
mkdir -p ~/.config/mpv/shaders
mv ravu-lite-r*.hook ~/.config/mpv/shaders/

mpv.conf を設定

mousepad ~/.config/mpv/mpv.conf

次の行を追加。詳しい説明はマニュアルを参照。

# ビデオ出力ドライバー
vo=gpu-next

# グラフィックスAPI
gpu-api=vulkan

# ハードウェアビデオデコードを有効にしてAPIを自動的に選択
#     選択されたAPIはターミナルに表示される。
hwdec=auto

# av1 がサポートされていない場合は以下のリストから av1 を削除
hwdec-codecs=h264,vc1,hevc,vp8,vp9,av1,prores

# アップスケーラー
#     glsl-shader はシェーダーリストにシェーダーを1個追加し、
#     glsl-shaders はシェーダーリストを上書きする。
#     ~~/ は mpv の設定ディレクトリを表す。
glsl-shader="~~/shaders/ravu-lite-ar-r3.hook"

# ダウンスケーラー
dscale=lanczos

# オーディオ出力ドライバー
ao=pipewire

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

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

# ターミナル出力の冗長性を減らす
quiet=yes

# オンスクリーンコントローラー
#     右下の「残り時間」を「全体時間」に変更。
script-opts=osc-timetotal=yes

input.conf を設定

mousepad ~/.config/mpv/input.conf

次の行を追加。デフォルトはこちら。

# 右クリックで一時停止しない
MBTN_RIGHT ignore

# マウスホイールで音量変更しない
WHEEL_UP ignore
WHEEL_DOWN ignore

# チルトホイールで10秒移動しない
WHEEL_LEFT ignore
WHEEL_RIGHT ignore

# プレイリストの次/前のファイルに移動するとき、プレイリストを2秒表示
MBTN_FORWARD playlist-next; show-text ${playlist} 2000
MBTN_BACK playlist-prev; show-text ${playlist} 2000

# ., でプレイリストの次/前のファイルに移動
. playlist-next; show-text ${playlist} 2000
, playlist-prev; show-text ${playlist} 2000

# PageUp と Shift+PageUp のコマンドを入れ替える
PGUP seek 600
PGDWN seek -600
Shift+PGUP add chapter 1
Shift+PGDWN add chapter -1

# i と I のコマンドを入れ替える
i script-binding stats/display-stats-toggle
I script-binding stats/display-stats

# Ctrl+d で再生中のファイルをゴミ箱に移動
Ctrl+d run gio trash "${path}"; playlist-remove current; show-text "\"${filename}\" をゴミ箱に移動しました" 5000

# Esc で終了
ESC quit

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

モニターに超解像技術が搭載されている場合はオフにする。アップスケーラーの効果がわかりづらくなるので。
REGZA をモニターとして使用している場合は次のようにする。

• 低遅延モード: オン
• レゾリューションプラス: オフ
• ヒストグラムバックライト制御: オン
• 質感リアライザー: オート

質感リアライザーをオフにすると全体の色味が白っぽくなる。

アップスケーラーの違いを比較

比較用のアップスケーラーをインストール

# RAVU
# Google の超解像技術から着想を得たアップスケーラー。
#     gather ディレクトリのものは OpenGL の textureGather() 関数を使用する。
#     compute ディレクトリのものはコンピュートシェーダーで、Vulkan が必要。
#     ルートディレクトリのものは上の2つが動作しない古いGPU用。
#         私の環境では compute ディレクトリのものが最速だった。
#     ravu-lite-ar はアンチリンギングを行う。
# https://github.com/bjin/mpv-prescalers
wget https://raw.githubusercontent.com/bjin/mpv-prescalers/refs/heads/master/compute/ravu-lite-r3.hook
wget https://raw.githubusercontent.com/bjin/mpv-prescalers/refs/heads/master/compute/ravu-lite-ar-r3.hook
mkdir -p ~/.config/mpv/shaders
mv ravu-lite-*.hook ~/.config/mpv/shaders/

# CuNNy
# CNN（畳み込みニューラルネットワーク）ベースのアップスケーラー。
#     DS はデノイズ（ノイズ除去）とシャープニングを行うようトレーニングされている。
#     SOFT はアンチエイリアスとソフトな出力を行うようトレーニングされており、
#     アーティファクトが少ない。
# https://github.com/funnyplanter/CuNNy
wget https://raw.githubusercontent.com/funnyplanter/CuNNy/refs/heads/master/mpv/ds/CuNNy-fast-DS.glsl
wget https://raw.githubusercontent.com/funnyplanter/CuNNy/refs/heads/master/mpv/soft/CuNNy-fast-SOFT.glsl
mv CuNNy-*.glsl ~/.config/mpv/shaders/

# ArtCNN
# アニメコンテンツを対象としたアップスケーラー。
#     DS はデノイズ（ノイズ除去）とシャープニングを行う。
# https://github.com/Artoriuz/ArtCNN
wget https://raw.githubusercontent.com/Artoriuz/ArtCNN/refs/heads/main/GLSL/ArtCNN_C4F16.glsl
wget https://raw.githubusercontent.com/Artoriuz/ArtCNN/refs/heads/main/GLSL/ArtCNN_C4F16_DS.glsl
mv ArtCNN_C4F*.glsl ~/.config/mpv/shaders/

# FSRCNNX
# CNN (畳み込みニューラルネットワーク) を使用した超解像アップスケーラー。
# https://github.com/igv/FSRCNN-TensorFlow/releases
wget https://github.com/igv/FSRCNN-TensorFlow/releases/download/1.1/FSRCNNX_x2_8-0-4-1.glsl
mv FSRCNNX_x2_*.glsl ~/.config/mpv/shaders/

# Anime4K
# 1080pアニメの4K化に最適化されたシェーダー。
#     本来はいくつかのシェーダーを組み合わせて使用するが、
#     標準の組み合わせだと色化けすることがあるので、
#     ここでは Anime4K_Upscale_Denoise_CNN_x2 のみを使用する。
# https://github.com/bloc97/Anime4K
wget https://raw.githubusercontent.com/bloc97/Anime4K/refs/heads/master/glsl/Upscale%2BDenoise/Anime4K_Upscale_Denoise_CNN_x2_M.glsl
mv Anime4K_Upscale_Denoise_CNN_x2_*.glsl ~/.config/mpv/shaders/

# ACNet
# Anime4KCPP によって実装されたCNNアルゴリズム。
# https://github.com/TianZerL/ACNetGLSL
wget https://raw.githubusercontent.com/TianZerL/ACNetGLSL/refs/heads/master/glsl/ACNet.glsl
mv ACNet.glsl ~/.config/mpv/shaders/

#
# 以下は紹介のみ
#

# SSimSuperRes
# シャープニングとアンチリンギングを行う。
# https://gist.github.com/igv

# NVScaler
# NVIDIA Image Scaling v1.0.2 の移植。AMDでも使用できる。
# https://gist.github.com/agyild

# SGSR
# Qualcomm Snapdragon Game Super Resolution (GSR) v1 の移植。
# https://gist.github.com/agyild

# FSR, CAS-scaled
#     ソースのコメントによると、アップスケールは最大で縦2倍まで。
# https://gist.github.com/agyild

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

mousepad ~/.config/mpv/input.conf

次の行を追加。別のアップスケーラーを使う場合は書き換える。
デフォルトのアップスケーラーは2023年9月に Bilinear から Lanczos に変更された。

# シェーダーの切り替え
CTRL+1 no-osd change-list glsl-shaders set "~~/shaders/ravu-lite-r3.hook"; show-text "ravu-lite-r3.hook"
CTRL+2 no-osd change-list glsl-shaders set "~~/shaders/ravu-lite-ar-r3.hook"; show-text "ravu-lite-ar-r3.hook"
CTRL+3 no-osd change-list glsl-shaders set "~~/shaders/CuNNy-fast-DS.glsl"; show-text "CuNNy-fast-DS.glsl"
CTRL+4 no-osd change-list glsl-shaders set "~~/shaders/CuNNy-fast-SOFT.glsl"; show-text "CuNNy-fast-SOFT.glsl"
CTRL+5 no-osd change-list glsl-shaders set "~~/shaders/ArtCNN_C4F16_DS.glsl"; show-text "ArtCNN_C4F16_DS.glsl"
CTRL+6 no-osd change-list glsl-shaders set "~~/shaders/ArtCNN_C4F16.glsl"; show-text "ArtCNN_C4F16.glsl"
CTRL+7 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+8 no-osd change-list glsl-shaders set "~~/shaders/Anime4K_Upscale_Denoise_CNN_x2_M.glsl"; show-text "Anime4K_Upscale_Denoise_CNN_x2_M.glsl"
CTRL+9 no-osd change-list glsl-shaders set "~~/shaders/ACNet.glsl"; show-text "ACNet.glsl"
CTRL+0 no-osd change-list glsl-shaders clr ""; set scale lanczos; show-text "lanczos"

画像を表示して違いを比較

画像の改変と再配布を許可してくださった皆様に感謝。

Source: “Shallow Focus Photography of Woman” by Liam Anderson
License: English, 日本語

縦480にリサイズした画像を全画面にアップスケール。

mpv http://linuxplayers.g1.xrea.com/images/mpv/pexels-liam-anderson-411198-1458332_480.jpg --fs --pause

「Ctrl」を押したまま 0 から 9 まで押していき、違いを比較する。

シャープネスが強いアップスケーラーは髪がごわつく。
アニメ特化のアップスケーラーは髪がのっぺりする。

縦480へのリサイズは次のように行った。

for file in *.jpg
do
  magick "$file" -resize x480 -quality 90 "${file%.jpg}_480.jpg"
done

# Quality の確認方法
# magick identify -verbose *.jpg | grep Quality

Source: “千と千尋の神隠し 作品静止画” by STUDIO GHIBLI
License: 画像は常識の範囲でご自由にお使いください。

縦480にリサイズした画像を全画面にアップスケール。

mpv http://linuxplayers.g1.xrea.com/images/mpv/chihiro030_480.jpg --fs --pause

「Ctrl」を押したまま 0 から 9 まで押していき、違いを比較する。

比較した結果 CuNNy-fast-DS.glsl をデフォルトにする場合は、~/.config/mpv/mpv.conf を変更。

# アップスケーラー
glsl-shader="~~/shaders/CuNNy-fast-DS.glsl"

lanczos をデフォルトにする場合

# アップスケーラー
scale=lanczos

コマ落ちが発生しないか確認

Source: “Aerial view of a boat sailing in the sea” by Burak Evlivan
License: English, 日本語

縦480にリサイズした動画をノーウェイトで全画面再生して、終了までの時間を計測。

wget -N http://linuxplayers.g1.xrea.com/images/mpv/12393381_3840_2160_60fps_480.mp4

# SGSR.glsl で再生する場合
time mpv --audio=no --untimed=yes --video-sync=display-desync --vulkan-swap-mode=immediate --opengl-swapinterval=0 --glsl-shaders="~~/shaders/SGSR.glsl" --fs 12393381_3840_2160_60fps_480.mp4

結果が「real 0m3.869s」のように表示される。
動画の収録時間は25秒なので、25秒以上かかるものはコマ落ちする。

縦480へのリサイズは次のように行った。

ffmpeg -i 12393381_3840_2160_60fps.mp4 -vf scale=854:480:flags=lanczos 12393381_3840_2160_60fps_480.mp4

Speed comparison of mpv upscalers

I wrote mpv_shader_benchmark.py to measure the processing speed.

python mpv_shader_benchmark.py <shaders>

Test system:

ダウンスケーラーの違いを比較

ダウンスケーラーをインストール。

# SSimDownscaler
# https://gist.github.com/igv
wget https://gist.githubusercontent.com/igv/36508af3ffc84410fe39761d6969be10/raw/38992bce7f9ff844f800820df0908692b65bb74a/SSimDownscaler.glsl
mv SSimDownscaler.glsl ~/.config/mpv/shaders/

~/.config/mpv/input.conf を一時的に変更。

# シェーダーの切り替え
CTRL+1 no-osd change-list glsl-shaders clr ""; set dscale hermite; show-text "hermite"
CTRL+2 no-osd change-list glsl-shaders clr ""; set dscale lanczos; show-text "lanczos"
CTRL+3 no-osd change-list glsl-shaders set "~~/shaders/SSimDownscaler.glsl"; set dscale hermite; set linear-downscaling no; show-text "SSimDownscaler.glsl"

こちらの画像をダウンロード。

Source: “Shallow Focus Photography of Woman” by Liam Anderson

縦1000にダウンスケールして表示。

mpv pexels-liam-anderson-411198-1458332.jpg --autofit=x1000 --window-maximized=no --pause

「Ctrl」を押したまま 1 から 3 まで押していき、違いを比較する。

1 から順に髪のシャープネスが強くなっていく。

比較した結果 SSimDownscaler をデフォルトにする場合は、~/.config/mpv/mpv.conf を変更。

# ダウンスケーラー
linear-downscaling=no
glsl-shader="~~/shaders/SSimDownscaler.glsl"

hermite をデフォルトにする場合

# ダウンスケーラー
dscale=hermite

HOME