Skip to content

命令参考

本节列出 mpv 的所有可用命令。

播放控制命令

播放/暂停

bash
# 暂停/继续
cycle pause

# 暂停
set pause yes

# 继续
set pause no

停止

bash
# 停止播放
stop

# 退出
quit

# 退出并保存位置
quit-watch-later

跳转命令

时间跳转

bash
# 跳转到指定时间
seek 120
seek 1:30
seek 01:30:00

# 相对跳转
seek 10
seek -10

# 精确跳转
seek 10 exact
seek -10 exact

章节跳转

bash
# 下一章
add chapter 1

# 上一章
add chapter -1

# 跳转到指定章节
set chapter 3

音量命令

音量控制

bash
# 设置音量
set volume 80

# 增加音量
add volume 10

# 减少音量
add volume -10

# 静音
cycle mute

音频延迟

bash
# 设置音频延迟
set audio-delay 0.1

# 增加音频延迟
add audio-delay 0.1

# 减少音频延迟
add audio-delay -0.1

字幕命令

字幕控制

bash
# 下一字幕
cycle sub

# 上一字幕
cycle sub down

# 显示/隐藏字幕
cycle sub-visibility

字幕延迟

bash
# 设置字幕延迟
set sub-delay 0.1

# 增加字幕延迟
add sub-delay 0.1

# 减少字幕延迟
add sub-delay -0.1

视频命令

视频控制

bash
# 下一视频轨道
cycle video

# 上一视频轨道
cycle video down

# 切换全屏
cycle fullscreen

截图命令

bash
# 截图
screenshot

# 截图到文件
screenshot-to-file filename.png

# 截图(不含字幕)
screenshot-to-file filename.png video

播放列表命令

播放列表控制

bash
# 下一个文件
playlist-next

# 上一个文件
playlist-prev

# 播放指定文件
playlist-play-index 2

播放列表管理

bash
# 添加到播放列表
playlist-add file.mp4

# 移除当前文件
playlist-remove current

# 清空播放列表
playlist-clear

显示命令

OSD 显示

bash
# 显示文本
show-text "Hello World"

# 显示属性
show-text ${media-title}

# 显示时间
show-text ${time-pos}/${time-remain}

信息显示

bash
# 显示统计信息
script-message stats

# 显示版本
show-text ${mpv-version}

属性命令

属性操作

bash
# 设置属性
set property value

# 增加属性
add property value

# 循环属性
cycle property

常用属性

bash
# 播放位置
set time-pos 120

# 音量
set volume 80

# 播放速度
set speed 1.5

# 全屏
set fullscreen yes

脚本命令

脚本消息

bash
# 发送脚本消息
script-message command arg1 arg2

# 发送全局消息
script-message-to script-name command arg1

脚本绑定

bash
# 绑定按键
keybind key command

# 解绑按键
keybind key ""

调试命令

调试信息

bash
# 显示属性
show-text ${property}

# 显示命令
show-text ${command}

# 显示配置
show-text ${config}

命令测试

bash
# 测试命令
command arg1 arg2

# 显示命令帮助
help command

下一步