音视频UI组件【免费下载链接】ModernZA sleek and modern OSC for mpv. This project is a fork of ModernX that enhances functionality by adding more features while preserving the core standards of mpvs OSC.项目地址https://gitcode.com/gh_mirrors/mo/ModernZ点击查看免费下载ModernZ 是一款精致现代的 mpv 屏幕控制界面OSC它不预置任何按键绑定把快捷键完全交给你在input.conf中配置。本教程将带你快速掌握script-binding与script-message-to两种绑定语法为 ModernZ 绑定显示/隐藏界面、循环显示模式、持久进度条等 5 个最常用快捷键。为什么 ModernZ 不默认绑定快捷键ModernZ 遵循 mpv 原生 OSC 的核心标准故意不设置默认按键以免与你现有的按键习惯冲突见 README.md 的说明。这意味着想用键盘操作 OSC需要自己在input.conf中添加绑定这正是script-binding和script-message的用武之地 鼠标操作左键/右键/中键不受影响完整的鼠标交互说明见 docs/CONTROLS.mdinput.conf 文件在哪里打开你的 mpv 配置目录下的input.conf没有就新建一个系统路径Linux~/.config/mpv/input.confWindowsC:/Users/你的用户名/AppData/Roaming/mpv/input.confmacOS~/Library/Application Support/mpv/input.conf目录结构参考 README.mdinput.conf与mpv.conf位于同一目录modernz.lua则放在scripts/子目录中。script-binding 与 script-message-to 的核心区别这两种命令都能让 mpv 把按键转发给 Lua 脚本但对接的注册接口不同对比项script-bindingscript-message-to脚本端注册方式mp.add_key_binding(nil, 名称, ...)mp.register_script_message(名称, ...)命令格式键位 script-binding 脚本名/绑定名键位 script-message-to 脚本名 消息名 [参数]能否传参数❌ 不能✅ 可以典型用途固定动作开关切换、循环模式带具体取值的动作设置某个模式在 ModernZ 源码中可以直观看到两套接口按键绑定接口modernz.lua 中注册了visibility、progress-toggle两个绑定消息接口modernz.lua 中注册了osc-visibility、osc-show、osc-hide、osc-idlescreen四个消息5 个最常用的 ModernZ 快捷键绑定把以下内容添加到input.conf即可获得完整的键盘控制能力v script-binding modernz/visibility # 循环切换显示模式 V script-message-to modernz osc-visibility cycle # 设置显示模式cycle、auto、always、never w script-binding modernz/progress-toggle # 开关持久进度条 x script-message-to modernz osc-show # 显示 OSC 界面 y script-message-to modernz osc-hide # 隐藏 OSC 界面 z script-message-to modernz osc-idlescreen # 开关空闲画面键位可自由替换成你习惯的按键。以下逐一说明每个绑定背后的机制。循环显示模式script-binding 用法示范v script-binding modernz/visibility对应源码中的 visibility 绑定每次按下会按visibility_modes选项默认never_auto_always即 never → auto → always 循环切换 OSC 的显示策略并弹出 OSD 提示当前模式。显示模式列表可通过modernz.conf中的visibility_modes选项自定义见 docs/USER_OPTS.md# modernz.conf位于 script-opts/ 目录 visibility_modesauto_always精确设置显示模式用 script-message-to 传参数script-binding无法传参数当你想直接跳到某个模式而不是循环时就需要script-message-to携带参数V script-message-to modernz osc-visibility always处理器 visibility_mode() 支持四种取值cycle从当前模式继续循环auto鼠标移动时才显示默认always始终显示never从不显示⚠️ 注意拼错模式名如写成Always会收到Ignoring unknown visibility mode警告见 modernz.lua。持久进度条开关w script-binding modernz/progress-toggle调用 progress-toggle 绑定每次按下切换persistent_progress选项让进度条在非交互状态下也保持可见非常适合边看边拖进度的场景。显示与隐藏 OSCx script-message-to modernz osc-show # 立即显示界面 y script-message-to modernz osc-hide # 立即隐藏界面仅 auto 模式下有效其中osc-hide的处理逻辑见 modernz.lua只有当前处于auto模式时才会隐藏always模式下按此键无效属于正常行为。空闲画面开关z script-message-to modernz osc-idlescreen对应 idlescreen_visibility()控制无媒体播放时是否显示 ModernZ 的空闲画面logo 等。进阶把 ModernZ 按钮命令也绑到键盘上ModernZ 中每个按钮的点击动作本质上也是一条script-binding命令例如 modernz.conf 中播放列表按钮的默认命令就是script-binding select/select-playlist。因此你可以把这些现成命令直接抄进input.conf实现键盘版按钮F9 script-binding select/select-playlist # 打开交互式播放列表 F10 script-binding select/select-audio-device # 打开音频设备选择 F11 script-binding stats/display-page-1-toggle # 打开文件统计信息类似的命令清单可在 modernz.conf 与 docs/USER_OPTS.md 的按钮命令表中查到包括select/select-aid音频轨、select/select-sid字幕轨、select/select-chapter章节列表等。实用示例右键上下文菜单与图片模式绑定 mpv 上下文菜单ModernZ 整合了 mpv 内置的select.lua脚本需 mpv v0.39推荐把右键绑到上下文菜单可快速切换布局、主题、语言MBTN_RIGHT script-binding select/context-menu详见 docs/INTERACTIVE_MENUS.md。图片浏览模式滚轮缩放ModernZ 的图片查看器同样依赖script-binding且演示了如何传递参数缩放方向WHEEL_UP {image} script-binding positioning/cursor-centric-zoom 0.1 WHEEL_DOWN {image} script-binding positioning/cursor-centric-zoom -0.1{image}是条件前缀表示仅在查看图片时生效。完整配置见 docs/IMAGE_VIEWER.md。 附带脚本 extras/open-file/ 也使用同样的绑定方式如Ctrlo script-binding open_file/open可直接在播放中打开文件、添加字幕或音轨。常见问题排查现象原因与解决按键按了没反应检查脚本名拼写必须是modernz脚本文件名modernz.lua去掉扩展名绑定名区分大小写script-binding绑定不生效确认用的是/分隔形式脚本名/绑定名漏写/是最高频错误提示Ignoring unknown visibility modeosc-visibility的参数只能是cycle、auto、always、never小写形式菜单类按键如 select无反应需要 mpvv0.39 及以上版本旧版本请使用 docs/INTERACTIVE_MENUS.md 中的替代方案osc-hide没效果当前处于always模式时该消息会被忽略先按V切回auto总结ModernZ 不预置快捷键全部通过input.conf自行绑定互不干扰script-binding对接mp.add_key_binding注册的固定动作modernz/visibility、modernz/progress-togglescript-message-to对接mp.register_script_message注册的可传参动作osc-visibility、osc-show、osc-hide、osc-idlescreen按钮命令select/*、stats/*可直接复用到键盘搭配上下文菜单与图片模式键盘效率直接拉满完整选项参考 docs/USER_OPTS.md鼠标交互参考 docs/CONTROLS.md。赞分享音视频UI组件【免费下载链接】ModernZA sleek and modern OSC for mpv. This project is a fork of ModernX that enhances functionality by adding more features while preserving the core standards of mpvs OSC.项目地址https://gitcode.com/gh_mirrors/mo/ModernZ点击查看免费下载相关推荐VSS与企业系统(WMS/ERP)集成指南让视频洞察驱动业务决策VSS与企业系统 WMS/ERP 集成指南让视频洞察驱动业务决策 NVIDIA VSSVideo Search and Summarization视频搜索人工智能大模型AI AgentRAG计算机视觉视频后端SumatraPDF 键盘快捷键完全指南默认按键表、查找与自定义绑定原理SumatraPDF 键盘快捷键完全指南默认按键表、查找与自定义绑定原理 本篇技术指南以 Keyboard shortcuts.md https://link桌面应用文档Kando快捷键绑定终极指南全局快捷键和自定义触发方式完全教程Kando快捷键绑定终极指南全局快捷键和自定义触发方式完全教程 Kando是一款高效的跨平台饼状菜单工具通过快捷键绑定可以帮助用户实现快速操作和任务执行。本桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考