uosc

项目概述

uosc 是一款为 mpv 播放器开发的界面脚本，用 Lua 编写，主打极简与基于光标接近程度（proximity）的交互。界面元素不再随手一动鼠标就跳出来，而是根据光标靠近哪个控件来决定显示，让你完全掌控界面何时出现、何时消失。它还提供可自定义的控制栏、上下文菜单、缩略图与字幕下载等能力。

让 mpv 的界面只在该出现的时候出现，安静而高效。

主要功能

• 接近式显示：界面按光标与控件的接近程度显示或隐藏，不再随鼠标移动全部弹出
• 时间轴收起：时间轴闲置时可缩成一条细小的进度条
• 自定义菜单：在 input.conf 中自行搭建带嵌套的上下文菜单
• 可配置控制栏：控制栏的按钮与布局可按需调整
• 缩略图预览：与 thumbfast 集成，提供快速高效的缩略图
• 轨道选择界面：为字幕、音频与视频轨道提供选择界面
• 字幕下载：从 OpenSubtitles 下载字幕，也支持加载外部字幕文件
• 画质选择：提供串流画质的选择界面
• 目录与播放列表导航：快速跳转目录与播放列表
• 菜单即搜：所有菜单都支持直接输入关键字检索
• 滚轮上下文操作：滚轮在时间轴、音量条、速度条上分别执行快进、调音量与调速
• 章节转时间轴区间：把章节映射为时间轴上的可点击区间

适用人群

• 使用 mpv 并希望界面更干净的进阶用户
• 喜欢用键盘与滚轮高效操作的用户
• 需要在线字幕与缩略图预览的人
• 想自定义菜单与工具栏的折腾党

快速上手

1. Windows 可运行 PowerShell 安装命令，Linux 与 macOS 可运行 Bash 安装脚本
2. 也可手动下载 uosc.zip 与 uosc.conf，解压到 mpv 的配置目录与 script-opts 中
3. 按需在 mpv.conf 中关闭 osd-bar 并关闭窗口边框，让界面更统一
4. 想要时间轴缩略图时，安装 thumbfast，uosc 会自动集成
5. 编辑 input.conf 搭建自己的菜单与快捷键
6. 在 uosc.conf 中查看并调整全部选项与默认值

核心优势

• 界面克制：只在需要时出现，不干扰观看
• 操作高效：菜单可搜索，滚轮在不同控件上各司其职
• 功能齐全：字幕下载、轨道选择、缩略图一站到位
• 可扩展：提供第三方脚本 API，可复用 uosc 渲染菜单

系统要求

项目	要求
播放器	mpv 0.33 及以上
Linux/macOS 安装	需要 curl 与 unzip
可选依赖	thumbfast（时间轴缩略图）

注意事项

• 播放视频时若界面显得迟滞，可用 video-sync=display-resample 缓解，但会增加 CPU 与 GPU 负载
• 界面渲染频率与视频帧率绑定是 mpv 的限制，暂停时会更顺滑
• 安装包可能被杀毒软件误报，属常见误判