通用选项
本节列出 mpv 的通用播放器选项。
播放控制
循环播放
bash
# 单文件循环
loop-file=inf
loop-file=3
# 播放列表循环
loop-playlist=inf
loop-playlist=3
# 禁用循环
loop-file=no
loop-playlist=no播放速度
bash
# 设置播放速度
speed=1.0
speed=1.5
speed=0.5
# 速度范围
speed-max=8.0
speed-min=0.01起始位置
bash
# 从指定时间开始
start=120
start=1:30
start=01:30:00
# 从指定百分比开始
start=50%
# 从指定章节开始
start=chapter=3结束位置
bash
# 在指定时间结束
end=300
end=5:00
# 在指定百分比结束
end=80%
# 在指定章节结束
end=chapter=5播放器行为
播放器操作模式
bash
# 标准播放器模式
player-operation-mode=player
# 伪 GUI 模式
player-operation-mode=pseudo-gui退出行为
bash
# 播放结束后退出
keep-open=no
# 播放结束后保持窗口
keep-open=yes
# 播放结束后暂停
keep-open-pause=yes位置保存
bash
# 退出时保存播放位置
save-position-on-quit=yes
# 禁用位置保存
save-position-on-quit=no窗口控制
窗口标题
bash
# 默认标题
title="${media-title}"
# 自定义标题
title="mpv - ${media-title}"
# 固定标题
title="My Player"窗口大小
bash
# 指定大小
geometry=1280x720
# 指定位置
geometry=100:100
# 指定大小和位置
geometry=1280x720+100+100
# 百分比大小
geometry=50%x50%窗口状态
bash
# 全屏
fullscreen=yes
# 窗口置顶
ontop=yes
# 无边框
border=no
# 最大化
window-maximized=yes显示控制
OSD 设置
bash
# OSD 级别
osd-level=1
osd-level=2
osd-level=3
# OSD 持续时间
osd-duration=2000
# OSD 字体
osd-font="Noto Sans CJK SC"
# OSD 字体大小
osd-font-size=40进度条
bash
# 显示进度条
osd-bar=yes
# 进度条位置
osd-bar-align-x=center
osd-bar-align-y=bottom
# 进度条大小
osd-bar-w=80
osd-bar-h=2终端控制
终端输出
bash
# 启用终端输出
term-osd=yes
# 终端标题
term-title="mpv - ${media-title}"
# 终端状态
term-status-msg="Playing: ${media-title}"消息级别
bash
# 消息级别
msg-level=all=v
msg-level=all=warn
msg-level=all=error
# 特定模块消息级别
msg-level=vo=v
msg-level=ao=v系统控制
配置文件
bash
# 使用配置文件
config=yes
# 禁用配置文件
config=no
# 配置文件路径
config-dir=~/.config/mpv脚本
bash
# 加载脚本
script=file.lua
script=file.js
# 脚本目录
script-dir=~/.config/mpv/scripts插件
bash
# 加载插件
input-file=file.conf
# 插件目录
input-conf=~/.config/mpv/input.conf调试选项
调试信息
bash
# 显示调试信息
debug=yes
# 显示性能统计
stats=yes
# 显示帧信息
framedrop=decoder日志控制
bash
# 日志文件
log-file=mpv.log
# 日志级别
msg-level=all=v