mpv 播放器

主题

OPTIONS（选项） ​

本节列出 mpv 的所有命令行选项。所有选项除了 --no-* 变体外，都可以在配置文件中使用（去掉 -- 前缀）。

选项分类 ​

mpv 选项分为以下几类：

轨道选择 ​

  • --alang=<languagecode> - 指定音频语言优先级列表
  • --slang=<languagecode> - 指定字幕语言优先级列表
  • --vlang=<languagecode> - 指定视频语言优先级列表
  • --aid=<ID|auto|no> - 选择音频轨道
  • --sid=<ID|auto|no> - 选择字幕轨道
  • --vid=<ID|auto|no> - 选择视频轨道
  • --edition=<ID|auto> - 选择版本（Matroska 文件）

播放控制 ​

  • --start=<relative time> - 跳转到指定时间位置
  • --end=<relative time> - 在指定时间位置结束
  • --length=<relative time> - 限制播放时长
  • --speed=<0.01-100> - 播放速度
  • --loop=<N|inf> - 循环播放
  • --pause - 启动时暂停

视频输出 ​

  • --vo=<driver> - 视频输出驱动
  • --hwdec=<api> - 硬件解码
  • --video-aspect=<ratio> - 视频宽高比
  • --video-zoom=<value> - 视频缩放
  • --video-pan-x=<value> - 视频水平平移
  • --video-pan-y=<value> - 视频垂直平移
  • --video-rotate=<value> - 视频旋转
  • --deinterlace=<yes|no|auto> - 去隔行扫描

音频输出 ​

  • --ao=<driver> - 音频输出驱动
  • --volume=<0-100> - 音量
  • --mute=<yes|no> - 静音
  • --audio-delay=<seconds> - 音频延迟
  • --audio-device=<device> - 音频设备
  • --audio-samplerate=<Hz> - 音频采样率

字幕 ​

  • --sub-file=<filename> - 加载字幕文件
  • --sub-delay=<seconds> - 字幕延迟
  • --sub-font=<name> - 字幕字体
  • --sub-font-size=<size> - 字幕字体大小
  • --sub-color=<color> - 字幕颜色
  • --sub-border-size=<size> - 字幕边框大小

截图 ​

  • --screenshot-format=<format> - 截图格式
  • --screenshot-directory=<path> - 截图目录
  • --screenshot-template=<template> - 截图文件名模板
  • --screenshot-jpeg-quality=<0-100> - JPEG 截图质量

窗口 ​

  • --geometry=<WxH+X+Y> - 窗口大小和位置
  • --fullscreen - 全屏模式
  • --ontop - 窗口置顶
  • --border=<yes|no> - 窗口边框
  • --title=<string> - 窗口标题
  • --screen=<N> - 显示器选择

网络 ​

  • --network-timeout=<seconds> - 网络超时
  • --http-proxy=<proxy> - HTTP 代理
  • --user-agent=<string> - 用户代理
  • --cookies=<yes|no> - Cookies
  • --ytdl-format=<format> - youtube-dl 格式选择

缓存 ​

  • --cache=<yes|no> - 启用缓存
  • --demuxer-max-bytes=<bytes> - demuxer 最大缓存
  • --demuxer-readahead-secs=<seconds> - demuxer 预读取

OSD ​

  • --osd-level=<0-3> - OSD 级别
  • --osd-duration=<ms> - OSD 持续时间
  • --osd-font=<name> - OSD 字体
  • --osd-font-size=<size> - OSD 字体大小
  • --osd-bar=<yes|no> - 显示进度条

输入 ​

  • --input-conf=<path> - 输入配置文件
  • --input-ipc-server=<path> - IPC 服务器
  • --input-test - 输入测试模式
  • --cursor-autohide=<ms> - 鼠标自动隐藏

终端 ​

  • --terminal=<yes|no> - 终端输出
  • --msg-level=<module=level> - 消息级别
  • --log-file=<path> - 日志文件
  • --term-status-msg=<string> - 终端状态行

配置 ​

  • --config=<yes|no> - 使用配置文件
  • --config-dir=<path> - 配置目录
  • --profile=<name> - 应用配置文件
  • --show-profile=<name> - 显示配置文件

高级 ​

  • --lavfi-complex=<graph> - 复杂滤镜图
  • --script=<path> - 加载脚本
  • --script-opts=<key=value> - 脚本选项
  • --player-operation-mode=<mode> - 播放器操作模式

选项语法 ​

命令行语法 ​

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
# 列出所有选项
mpv --list-options

# 列出特定类型选项
mpv --list-options | grep video
mpv --list-options | grep audio

# 查看选项帮助
mpv --help=option

相关链接 ​