uosc_danmaku

项目概述

uosc_danmaku 是一个运行在 MPV 播放器中的弹幕扩展插件，基于 uosc UI 框架与弹弹play API，用于在 MPV 里加载弹弹play的弹幕。它把搜索、开关、样式调整等控件加入 uosc 控制栏，播放时点击即可搜索剧集并加载对应的弹幕，无需亲自下载整合弹幕文件或处理格式转换。插件通过项目维护的 API 代理访问弹弹play开放弹幕网络，普通用户无需注册账号或配置 AppId。在未安装 uosc 时，它也可调用 mpv 内部的 mp.input 渲染菜单。

在 MPV 里一键加载哔哩哔哩等站点的弹幕，不必手动找弹幕文件。

主要功能

• 一键搜索加载：通过控制栏的弹幕搜索按钮显示搜索菜单，选择需要的弹幕并加载
• 弹幕开关：控制栏中的开关控件可随时打开或关闭弹幕显示
• 样式菜单：可在播放时实时修改弹幕样式，未安装 uosc 时该功能不可用
• 设置总菜单：多级功能复合菜单，汇集插件目前所有的图形化功能
• 弹幕源延迟：可独立控制每个弹幕源的延迟，未安装 uosc 时该功能不可用
• 记忆型自动填装：为某集加载过弹幕后自动关联该文件与所在文件夹，之后再播放会自动加载
• 哈希匹配自动添加：在没有手动加载与记忆之前，通过文件哈希匹配自动关联弹幕
• 网络视频自动加载：配合 Play-With-MPV、ff2mpv 等手段播放时自动加载弹幕
• 从源补充弹幕：可通过受支持的网络源或本地文件向当前弹幕添加新内容
• 弹幕后处理：支持合并一定时间段内的重复弹幕、简繁转换、保存当前弹幕到本地
• 样式与提示可调：支持自定义默认弹幕样式，并可调节插件提示的显示位置

适用人群

• 想在 MPV 里观看弹幕的观众
• 使用 MPV_lazy 等懒人包的用户
• 希望自动加载并记忆弹幕的用户

快速上手

1. 为 MPV 安装 uosc UI 框架，或使用内置了 uosc 的懒人包
2. 将本插件下载或克隆到 mpv 配置目录的 scripts 目录下
3. 确认该插件所在文件夹名称为 uosc_danmaku，否则需相应修改 uosc 控件配置
4. 为 bin 文件夹下的文件赋予可执行权限
5. 修改 script-opts 中 uosc 的控件配置，让弹幕搜索按钮与开关显示在控制栏上
6. 也可通过绑定快捷键调用弹幕搜索与开关功能

核心优势

• 免维护弹幕源：插件默认通过项目维护的 API 代理访问弹弹play，无需自备 AppId
• 自动化程度高：记忆型填装与哈希匹配让常见剧集做到自动加载
• 功能齐全：搜索、开关、样式、延迟、合并、简繁转换与保存一应俱全
• 兼容性好：uosc 不可用时可通过 mpv 内部的 mp.input 渲染菜单

系统要求

项目	要求
播放器	MPV，建议安装 uosc UI 框架
系统	Linux 与 Windows；使用 mp.input 时需 mpv 0.39.0 及以上
哈希匹配	需 mpv 基于 LuaJIT 或 Lua 5.2 构建，不支持 Lua 5.1

注意事项

• 未安装 uosc 时，样式菜单与弹幕源延迟功能不可用
• 哈希匹配自动加载准确率较低，关联到错误剧集时请手动加载正确的剧集
• 记忆型自动弹幕填装默认关闭，需要开启请阅读配置项说明
• 网络视频自动加载目前支持哔哩哔哩与巴哈姆特两个网站
• API 代理包含缓存与访问频率限制，请勿用于批量抓取