选项概述
本节提供 mpv 所有选项的分类和使用方法。
选项分类
播放控制
输出控制
界面控制
功能控制
选项使用
命令行语法
bash
# 长选项
mpv --option=value video.mp4
# 短选项
mpv -o value video.mp4
# 布尔选项
mpv --option video.mp4
mpv --no-option video.mp4配置文件语法
bash
# 在 mpv.conf 中设置
option=value
option
no-option运行时命令
bash
# 设置选项
set option value
# 增加值
add option value
# 循环选项
cycle option选项值类型
字符串
bash
# 简单字符串
option=value
# 带空格的字符串
option=value with spaces
option="value with spaces"
# 特殊字符
option="value\"with\"quotes"数值
bash
# 整数
option=123
option=-456
# 浮点数
option=1.5
option=-3.14
# 百分比
option=50%
option=100%
# 时间
option=120
option=1:30
option=01:30:00布尔值
bash
# 启用
option=yes
option=on
option=true
option=1
# 禁用
option=no
option=off
option=false
option=0列表
bash
# 列表值
option=item1,item2,item3
# 追加到列表
option-append=item4
# 从列表移除
option-remove=item2颜色
bash
# 十六进制颜色
option=#RRGGBB
option=#RRGGBBAA
# 示例
option=#FF0000
option=#FF000080选项查找
列出所有选项
bash
# 列出所有选项
mpv --list-options
# 列出特定类型选项
mpv --list-options | grep video
mpv --list-options | grep audio查看选项帮助
bash
# 查看选项帮助
mpv --help=option
# 查看选项详细信息
mpv --option=help搜索选项
bash
# 搜索选项
mpv --list-options | grep -i "关键字"选项配置文件
主配置文件
bash
# ~/.config/mpv/mpv.conf
vo=gpu
hwdec=auto
volume=80配置文件片段
bash
# 包含其他配置文件
include=video.conf
include=audio.conf条件配置
bash
# 仅对特定格式应用配置
[extension.mkv]
video-aspect=16:9
# 仅对 DVD 应用配置
[dvd://]
dvd-speed=2选项继承
配置文件继承
bash
# 定义基础配置
[default]
vo=gpu
hwdec=auto
# 继承基础配置
[high-quality]
profile=default
profile=gpu-hq命令行覆盖
bash
# 命令行选项覆盖配置文件
mpv --vo=gpu --hwdec=auto video.mp4选项调试
查看当前配置
bash
# 显示当前配置
mpv --show-profile=gpu-hq
# 显示所有配置
mpv --show-profile验证选项
bash
# 验证选项
mpv --vo=gpu --hwdec=auto video.mp4
# 显示选项信息
mpv --msg-level=all=v video.mp4下一步
选择您需要的选项类别：