mpv 播放器

主题

输入选项 ​

本节列出 mpv 的输入设备和控制选项。

输入配置 ​

配置文件 ​

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

# 禁用默认绑定
no-input-default-bindings=yes

# 输入测试模式
input-test=yes

输入设备 ​

bash
# 输入设备
input-device=keyboard
input-device=mouse
input-device=joystick

# 禁用输入设备
no-input-devices=yes

键盘控制 ​

键盘配置 ​

bash
# 键盘重复延迟
input-keylist=

# 键盘重复率
input-keyrate=

快捷键绑定 ​

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

鼠标控制 ​

鼠标配置 ​

bash
# 鼠标隐藏时间（毫秒）
cursor-autohide=1000

# 禁用鼠标自动隐藏
cursor-autohide=no

# 双击时间（毫秒）
input-doubleclick-time=300

鼠标绑定 ​

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

遥控器控制 ​

遥控器配置 ​

bash
# 遥控器配置
input-remote-control=yes

# 遥控器设备
input-remote-device=/dev/input/event0

遥控器绑定 ​

bash
# 格式：遥控器按键 命令
PLAY cycle pause
STOP stop
NEXT playlist-next
PREV playlist-prev

输入命令 ​

命令接口 ​

bash
# 命令接口
input-commands=

# 命令文件
input-file=commands.conf

命令绑定 ​

bash
# 格式：按键 命令 参数
s screenshot
q quit
Q quit-watch-later

输入调试 ​

调试信息 ​

bash
# 显示输入信息
mpv --msg-level=all=v video.mp4

# 输入测试模式
mpv --input-test video.mp4

输入列表 ​

bash
# 列出所有输入
mpv --input-keylist

# 列出鼠标按钮
mpv --input-mousebuttonlist

输入脚本 ​

Lua 脚本输入 ​

lua
-- 添加快捷键
mp.add_key_binding('ctrl+s', 'screenshot', function()
    mp.command('screenshot')
end)

-- 添加鼠标绑定
mp.add_key_binding('MBTN_LEFT', 'toggle-pause', function()
    mp.command('cycle pause')
end)

JavaScript 脚本输入 ​

javascript
// 添加快捷键
mp.add_key_binding('ctrl+s', 'screenshot', function() {
    mp.command('screenshot');
});

// 添加鼠标绑定
mp.add_key_binding('MBTN_LEFT', 'toggle-pause', function() {
    mp.command('cycle pause');
});

输入配置文件 ​

配置文件格式 ​

bash
# ~/.config/mpv/input.conf

# 快捷键绑定
SPACE cycle pause
RIGHT seek 10
LEFT seek -10

# 鼠标绑定
MBTN_LEFT cycle pause
MBTN_RIGHT show-text ${media-title}

# 音量控制
WHEEL_UP add volume 2
WHEEL_DOWN add volume -2

配置文件继承 ​

bash
# 包含其他配置文件
input-include=extra-input.conf

# 禁用默认绑定
no-input-default-bindings=yes

输入故障排除 ​

常见问题 ​

  1. 快捷键不工作

    • 检查 input-conf 配置
    • 检查 no-input-default-bindings 设置

  2. 鼠标不响应

    • 检查 cursor-autohide 设置
    • 检查鼠标绑定配置

  3. 遥控器不工作

    • 检查遥控器设备配置
    • 检查遥控器绑定配置

调试命令 ​

bash
# 显示输入信息
mpv --msg-level=all=v video.mp4

# 输入测试模式
mpv --input-test video.mp4

下一步 ​