将哔哩哔哩的 弹幕 转化为 ass 文件
- 哔哩哔哩直播:录播姬等录制的 XML 格式文件
- 哔哩哔哩视频:支持 BV 号/B站链接(可带分 p 参数)
- 哔哩哔哩番组:支持 ss28281 / ep450006 或 https://www.bilibili.com/bangumi/play/ss28281 等链接
- 比 danmaku2ass 快一百倍的速度(见下方性能对比)
- 可交互、实时预览的 web UI
- 更紧密的弹幕填充算法(见下)
- 底部和顶部弹幕和逆向弹幕转成正常弹幕,减少遮挡
- 弹幕透明度、字体、字号、高度、间距、描边等全部可调
- 支持过滤黑名单关键词(cli 模式)
- 支持文件夹模式,递归查找所有 xml 文件并多线程处理(cli 模式)
- 自动判断是否已经转换过,跳过已转换的文件,方便自动化处理(cli 模式)
- 编译为二进制,支持 docker 部署,不需要 python 环境
xml 解析器默认使用 quick_xml
测试 238M 的文件:
quick-xml
:449.5ms 461.3ms 505.1ms 406.23msxml-rs
:18.0s 18.8s 18.2s 18.5sdanmaku2ass
:40.2s 40.8s 40.1s
danmuku2ass 使用命令行
python3 ../danmaku2ass/danmaku2ass.py -f Bilibili -s 1280x720 ./large.xml -o large.ass
- 下载 https://github.com/gwy15/danmu2ass/releases 中的 release
- 对于 Windows 用户,直接双击 danmu2ass.exe,会自动打开 web 界面。
- 或者使用 docker:
docker run -it --rm -v /tmp:/tmp gwy15/danmu2ass:main /tmp
如果你熟悉命令行,可以直接使用命令行。
./danmu2ass --help
danmu2ass 1.0.0
gwy15
将 XML 弹幕转换为 ASS 文件
USAGE:
danmu2ass.exe [OPTIONS] [INPUT]
ARGS:
<INPUT> 需要转换的输入,可以是 xml 文件、文件夹或是哔哩哔哩链接、BV
号。如果是文件夹会递归将其下所有 XML 都进行转换 [default: .]
OPTIONS:
-a, --alpha <ALPHA>
弹幕不透明度 [default: 0.7]
--bold
加粗
-d, --duration <DURATION>
弹幕在屏幕上的持续时间,单位为秒,可以有小数 [default: 15]
--denylist <DENYLIST>
黑名单,需要过滤的关键词列表文件,每行一个关键词
-f, --font <FONT>
弹幕使用字体。单位:像素 [default: 黑体]
--font-size <FONT_SIZE>
弹幕字体大小 [default: 25]
--force
默认会跳过 ass 比 xml 修改时间更晚的文件,此参数会强制转换
-h, --height <HEIGHT>
屏幕高度 [default: 720]
--help
Print help information
--horizontal-gap <HORIZONTAL_GAP>
每条弹幕之间的最小水平间距,为避免重叠可以调大这个数值。单位:像素 [default: 20.0]
-l, --lane-size <LANE_SIZE>
弹幕所占据的高度,即“行高度/行间距” [default: 32]
--no-web
不打开 web ui 而使用 cli 模式
-o, --output <ASS_FILE>
输出的 ASS 文件,默认为输入文件名将 .xml 替换为 .ass,如果输入是文件夹则忽略
--outline <OUTLINE>
描边宽度 [default: 0.8]
-p, --float-percentage <FLOAT_PERCENTAGE>
屏幕上滚动弹幕最多高度百分比 [default: 0.5]
--pause
在处理完后暂停等待输入
--time-offset <TIME_OFFSET>
时间轴偏移,>0 会让弹幕延后,<0 会让弹幕提前,单位为秒 [default: 0.0]
-V, --version
Print version information
-w, --width <WIDTH>
屏幕宽度 [default: 1280]
--width-ratio <WIDTH_RATIO>
计算弹幕宽度的比例,为避免重叠可以调大这个数值 [default: 1.2]