mpv_bangumi

KO | EN

gitlite — search

#javascript #react #typescript #golang #machine-learning #linux #docker #nodejs #macos #windows #security #pytorch #ios #openai

(★ 13)

danmaku and bangumi(番组计划) integration for mpv

mpv_bangumi 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mpv_bangumi

在mpv中使用dandanplay api加载弹幕，自动同步bangumi追番进度。

## 主要功能

- 自动识别番剧并加载弹幕
- 发送弹幕至dandanplay弹幕库（目前接口权限未开放，暂不可用）
- 自动同步bangumi追番进度
- [N站](https://www.nicovideo.jp)弹幕支持（支持LLM[自动翻译](#llm-config)）

其中弹幕播放功能参考[uosc_danmaku](https://github.com/Tony15246/uosc_danmaku)。
弹幕转换的功能主要基于[dmconvert](https://github.com/timerring/DanmakuConvert)修改。N站弹幕获取功能参考[yt-dlp](https://github.com/yt-dlp/yt-dlp)。

## 安装

本插件需要系统安装python环境，并手动安装依赖库。推荐python>=3.13，更低版本理论可以但未进行测试，windows用户若无python环境，在微软应用商店搜索安装最新版即可。

1. 下载本插件代码至mpv脚本目录（`~/.config/mpv/scripts/`）

```
git clone https://github.com/slqy123/mpv_bangumi.git ~/.config/mpv/scripts/
```

2. 安装依赖库

```shell
cd mpv_bangumi/bgm
# 如果是微软商店安装的python，还需要在powershell中额外运行：
# $env:PATH = "$env:PATH;$HOME\AppData\Local\microsoft\windowsapps"
python -m venv .venv

# 根据系统和shell环境选择合适的激活命令
source .venv/bin/activate  # for linux bash/zsh
source .venv/bin/activate.fish  # for linux fish
. .venv/Scripts/activate.ps1  # for windows powershell(pwsh)

pip install -e .
```

3. 初始化配置

运行`bgm`命令，将交互式生成初始配置文件。

4. 可选配置项

使用 `python -c "import appdirs; print(appdirs.user_config_dir('bgm'))"` 可查看配置文件夹位置。

可以在 `config.toml` 中修改弹幕样式：
```toml
[danmaku]
# 弹幕速度
scrolltime = 15
fixtime = 8
# 字体
fontname = "sans-serif"
# 大小
fontsize = 36
# 阴影
shadow = 1
# 粗体
bold = true
# 弹幕显示范围
displayarea = 0.5
# 描边
outline = 1.0
# 透明度
transparency = 0x30
```

<span id="llm-config">以及LLM自动翻译的相关设置：</span>
```toml
[llm]
enabled = true
base_url = "https://api.deepseek.com"  
model = "deepseek-v4-flash"            
```

`.env`中可以自定义API令牌
```shell
DANDANPLAY_APPID=...
DANDANPLAY_APPSECRET=...

BGM_ACCESS_TOKEN=...

LLM_API_KEY="sk-..."

# 暂时无用
DANDANPLAY_USERNAME=...
DANDANPLAY_PASSWORD=...
```

## 使用
- `ALT-M`: 手动匹配番剧(自动匹配未成功时使用)
- `ALT-O`: 打开番剧对应的 bangumi.tv 词条页面
- `SHIFT-C`: 发送弹幕
- `ALT-.`: 显示/隐藏 弹幕
- `ALT-Z/ALT-X`: 调整弹幕延迟
- `ALT-N`: N站弹幕设置

## 实现原理

Lua 脚本通过 mpv 的 `input-ipc-server` 实现 Python 子进程与 Lua 脚本的双向通信。

所有网络请求均在 Python 侧异步并行执行。同时引入文件锁，保证缓存数据一致性，支持多 mpv 实例同时运行。

通过 dandanplay 元数据获取 bangumi 条目信息；通过 [bangumi-data](https://github.com/bangumi-data/bangumi-data) 获取 nicovideo 视频地址。

## 一些碎碎念

从项目名字就能看出，原本这个项目是只想做bangumi的自动同步功能的，但由于uosc_danmaku也会用到dandanplay的api，这会涉及到重复的API请求。

加上uosc_danmaku的功能太多架构太复杂，有很多我不需要的功能。（如dandanplay以外的其他弹幕源支持，uosc集成）
索性就把核心的弹幕渲染功能拿出来重写了一下，后续自己想添加其他的功能也更方便。

那为什么选Python呢？那当然是因为~~Python是世界上最好的编程语言。~~

好吧我也觉得这样依赖第三方程序调用的实现有点不优雅，不过最新版换成了IPC实现，整个mpv的生命周期内只会有一次Python调用，算是能接受的overhead了。

其实一开始尝试过使用embedded python做一个lua C 拓展，参考[luapython](https://github.com/imitoy/luapython)的实现，但原项目有很多功能还不太完善。
缺少`venv`和多线程的支持，在被GIL各种奇奇怪怪的死锁折腾得死去活来之后，我放弃了这个方案，也不知道mpv的官方python支持要等到猴年马月╮(╯_╰)╭。

mpv_bangumi

mpv_bangumi 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

mpv_bangumi

mpv_bangumi 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README