mpv 播放器

主题

COMMAND INTERFACE（命令接口） ​

mpv 有一个完全可配置的、命令驱动的控制层。

命令语法 ​

基本命令 ​

bash
# 命令格式
command argument1 argument2

# 示例
set volume 80
seek 10
cycle pause

命令类型 ​

bash
# 设置命令
set property value

# 增加命令
add property value

# 循环命令
cycle property

# 命令命令
command arg1 arg2

输入配置 ​

配置文件 ​

bash
# 输入配置文件
input-conf=~/.config/mpv/input.conf

按键绑定 ​

bash
# 格式：按键 命令
SPACE cycle pause
RIGHT seek 10
LEFT seek -10

鼠标绑定 ​

bash
# 格式：鼠标操作 命令
MBTN_LEFT cycle pause
MBTN_RIGHT show-text ${media-title}

常用命令 ​

播放控制 ​

bash
# 暂停/继续
cycle pause

# 停止
stop

# 退出
quit

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

跳转命令 ​

bash
# 时间跳转
seek 10
seek -10

# 章节跳转
add chapter 1
add chapter -1

音量命令 ​

bash
# 设置音量
set volume 80

# 增加音量
add volume 10

# 减少音量
add volume -10

# 静音
cycle mute

字幕命令 ​

bash
# 下一字幕
cycle sub

# 上一字幕
cycle sub down

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

视频命令 ​

bash
# 下一视频轨道
cycle video

# 切换全屏
cycle fullscreen

截图命令 ​

bash
# 截图
screenshot

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

命令接口 ​

JSON IPC ​

bash
# 启用 IPC
input-ipc-server=/tmp/mpv-socket

# 发送命令
echo '{"command": ["set_property", "volume", 80]}' | socat - /tmp/mpv-socket

脚本命令 ​

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

# 发送到特定脚本
script-message-to script-name command arg1

按键名称 ​

键盘按键 ​

  • 字母：a-z、A-Z
  • 数字：0-9
  • 功能键：F1-F12
  • 修饰键：Ctrl、Alt、Shift、Meta
  • 特殊键：SPACE、ENTER、ESC、TAB、BACKSPACE、DELETE
  • 箭头键：UP、DOWN、LEFT、RIGHT
  • 导航键：HOME、END、PGUP、PGDWN

鼠标按键 ​

  • MBTN_LEFT - 左键
  • MBTN_RIGHT - 右键
  • MBTN_MID - 中键
  • WHEEL_UP - 滚轮上滚
  • WHEEL_DOWN - 滚轮下滚

相关链接 ​