MPV播放器控制台功能详解与使用指南

段沙璐Blythe

于 2025-06-01 09:00:43 发布

阅读量305

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00382/article/details/148359903

MPV播放器控制台功能详解与使用指南

mpv 🎥 Command line video player 项目地址: https://gitcode.com/gh_mirrors/mp/mpv

控制台功能概述

MPV播放器内置了一个强大的控制台功能，为用户提供了与播放器交互的文本输入界面。这个控制台不仅可以在视频窗口上显示，也能在终端中使用，是高级用户进行播放器控制和脚本交互的重要工具。

控制台基础配置

控制台功能默认是启用的，但用户可以通过--load-console=no参数完全禁用它。控制台的核心功能包括：

处理用户通过mp.input API输入的文本
支持自由文本输入模式
提供预定义选项的选择功能

自由文本模式快捷键大全

基本操作

ESC/Ctrl+[：隐藏控制台
ENTER/Ctrl+j/Ctrl+m：执行当前命令（自动选择第一个补全项）
Shift+ENTER：输入实际换行符

光标移动

LEFT/Ctrl+b：向左移动一个字符
RIGHT/Ctrl+f：向右移动一个字符
Ctrl+LEFT/Alt+b：移动到当前/前一个单词开头
Ctrl+RIGHT/Alt+f：移动到当前/下一个单词结尾
HOME/Ctrl+a：移动到行首
END/Ctrl+e：移动到行尾

文本编辑

BACKSPACE/Ctrl+h：删除前一个字符
Ctrl+d：空行时隐藏控制台，否则删除后一个字符
Ctrl+BACKSPACE/Ctrl+w：删除到单词开头
Ctrl+DEL/Alt+d：删除到单词结尾
Ctrl+u：删除到行首
Ctrl+k：删除到行尾
Ctrl+c：清空当前行

历史记录

UP/Ctrl+p：查看上一条历史命令
DOWN/Ctrl+n：查看下一条历史命令
PGUP：跳转到第一条历史命令
PGDN：停止历史记录导航
Ctrl+r：搜索历史命令

其他功能

INSERT：切换插入模式
Ctrl+v：粘贴文本（X11/Wayland使用剪贴板）
Shift+INSERT：粘贴文本（X11使用主选择）
TAB/Ctrl+i：循环补全选项
Shift+TAB：反向循环补全选项
Ctrl+l：清除所有控制台日志
MBTN_MID：粘贴文本（X11使用主选择）
WHEEL_UP：查看上一条历史命令
WHEEL_DOWN：查看下一条历史命令

已知限制

非ASCII键盘输入：存在一定限制
光标移动：基于Unicode码点而非字形簇移动

高级配置选项

控制台可以通过配置文件script-opts/console.conf或--script-opts命令行参数进行深度定制。

主要配置参数

| 参数名 | 默认值 | 说明 | |--------|--------|------| | monospace_font | 平台相关 | 用于对齐补全项的等宽字体 | | font_size | 24 | 基础字体大小 | | border_size | 1.65 | 字体边框大小 | | background_alpha | 80 | 背景透明度(0-255) | | padding | 10 | 菜单内边距 | | menu_outline_size | 0 | 菜单边框大小 | | menu_outline_color | #FFFFFF | 菜单边框颜色 | | corner_radius | 8 | 菜单圆角半径 | | margin_x | 同--osd-margin-x | 窗口左侧边距 | | margin_y | 同--osd-margin-y | 窗口底部边距 | | scale_with_window | auto | 是否随窗口缩放(yes/no/auto) | | focused_color | #222222 | 焦点项颜色 | | focused_back_color | #FFFFFF | 焦点项背景色 | | match_color | #0088FF | 匹配字符颜色 | | exact_match | no | 是否精确匹配搜索 | | case_sensitive | no | 是否区分大小写(仅ASCII) | | history_dedup | true | 历史记录去重 | | font_hw_ratio | auto | 字体高宽比(1.8-2.5为常见值) |