目录
DanmakuRender 由开发者 SmallPeaches 在 GitHub 上开源并维护,项目已从早期的 V4 版本迭代至全新的 V5 架构。它通过 Python 脚本运行,核心是调用 FFmpeg 等工具处理视频流,并利用平台 API 获取弹幕数据。
这款工具的本质是一个“直播录制与后期处理自动化流水线”。它可以模拟一个观众,长时间守在直播间,忠实地录制直播内容。录制结束后,它能自动执行预设的渲染任务,将下载的弹幕文件压制到视频画面中,还能调用上传接口,把成品发布到你的视频平台账号上。整个过程无需人工干预,极大地解放了内容创作者的双手。
项目地址与下载
-
GitHub 项目主页:https://github.com/SmallPeaches/DanmakuRender
-
官方下载地址:https://github.com/SmallPeaches/DanmakuRender/releases (请在 Releases 页面下载版本,如 2026.01.10 版)
功能介绍
DanmakuRender V5 的功能围绕“录制”、“渲染”、“上传”和“调度”四大核心模块构建,通过一个 YAML 配置文件进行高度定制化的控制。
一、 多平台直播录制
-
广泛的平台支持:支持录制 Bilibili、抖音、虎牙、斗鱼、YouTube、TikTok、Twitch 等主流直播平台的直播流。
-
灵活的录制引擎:提供基于 Python 的
pyrequests引擎和传统的streamgears/ffmpeg引擎,可根据平台和网络状况选择。 -
智能化录制策略:支持检测主播开播后自动开始录制,主播下播后自动停止;支持强制录制 B 站原画画质;支持在主播未开播时循环检测,不浪费系统资源。
二、 弹幕获取与渲染
-
多平台弹幕捕获:在录制视频的同时,可自动捕获并保存直播间的弹幕文件(是 XML 或 ASS 格式)。
-
强大的弹幕渲染:录制完成后,可自动将保存的弹幕文件渲染到视频画面中,支持调整弹幕的字体、大小、速度、透明度、显示区域等参数,生成带有“弹幕回放”效果的视频。
-
纯弹幕录制模式:可设置为只录制弹幕文件,不录制视频流,满足只想收集弹幕数据的需求。
三、 自动化后处理与上传
-
自动渲染与分段:支持在录制完成后自动触发渲染任务。可以按录制时长或文件大小自动对视频进行分段处理,便于上传和观看。
-
多平台自动上传:内置上传模块,支持将渲染好的视频自动上传到 Bilibili 等视频平台,并可预设标题、简介、标签、分区、封面图等信息,实现无人值守发布。
四、 高级调度与任务管理
-
虚拟录制:这是一个特色功能,可以用于“搬运”已有的直播回放或视频,将模拟为直播流进行处理,用于测试或二次创作。
-
灵活的配置系统:所有功能均通过一个 YAML 配置文件进行控制。你可以定义全局参数,也可以为不同的主播创建独立的配置任务,互不干扰。
-
定时与循环任务:可以设置软件在特定时间段内运行监控,或循环执行某个任务,适合长期挂机使用。
五、 硬件加速支持
为提升视频渲染和转码效率,软件支持调用硬件加速编码器:
-
NVIDIA 显卡:支持
h264_nvenc或hevc_nvenc编码器。 -
AMD 显卡:支持
h264_amf或hevc_amf编码器。 -
Intel 核显:支持
h264_qsv或hevc_qsv编码器。 -
CPU:默认使用
libx264或libx265软件编码。
应用场景
-
虚拟主播与内容创作者:无人值守录制自己的直播,自动生成带弹幕的回放视频并发布,维持账号活跃度。
-
直播观众与粉丝:长期关注某位主播,想要完整收藏直播录像和弹幕,用于个人回顾或二次剪辑。
-
MCN 机构与运营团队:批量管理多个主播账号的直播录制与发布任务,建立标准化的内容存档和分发流程。
-
网络数据研究者:收集特定直播间的弹幕数据,用于分析观众互动模式或舆情研究。
关键信息
-
定价策略:DanmakuRender 是一款免费的开源软件,基于 GPL-3.0 许可证发布,无任何收费项目。
-
系统支持:软件基于 Python 开发,理论上支持 Windows、macOS 和 Linux。由于依赖 FFmpeg,在使用前需要确保系统已正确安装 FFmpeg 并配置好环境变量。
-
运行方式:主要有两种运行方式:
-
直接运行可执行文件:下载 Releases 中的
DanmakuRender.exe(Windows 版)或二进制文件,双击运行。 -
运行 Python 脚本:安装 Python 环境及相关依赖后,通过命令行执行
main.py。
-
-
配置示例:首次使用需要编辑
config.yml文件。你需要填写待录制直播间的 URL、选择是否录制弹幕和视频、设置输出路径,如果需自动上传,还要填写 B 站等平台的 Cookie 或 Access Token。官方文档有详细的配置说明。
| 源码反馈/咨询 (共有 条反馈) |
DanmakuRender常见问题
DanmakuRender不是公司产品,而是由GitHub用户SmallPeaches个人开发并开源维护的项目。
DanmakuRender是一款用于自动录制网络直播、渲染弹幕并上传视频的开源工具,可以看作一个直播内容自动化处理流水线。
从GitHubReleases下载版本并解压。然后根据官方文档编辑config.yml配置文件,填入你要录制的主播房间号、平台、以及是否渲染弹幕和上传。配置好后,双击运行主程序即可,它会按照你的设置自动工作。
是的,DanmakuRender是一款基于GPL-3.0协议的开源软件,免费,无任何付费功能。
软件本身是开源的,代码公开,安全性较高。需要留意的是,如果你使用自动上传功能,需要在配置文件中填写视频平台的Cookie或Token。这些敏感信息保存在你的本地文件中,软件不会主动上传。建议妥善保管配置文件,不要泄露给他人。
一个关键的技巧是善用“分段录制”功能。在配置文件中设置好按时间或文件大小分段,可以避免单个视频文件过大导致上传失败或渲染缓慢,也更方便后续剪辑。为不同的主播创建独立的配置任务文件,管理起来会更清晰。
核心特色在于自动化流程整合。将“录制-弹幕渲染-上传”这三个步骤串成一个全自动的流水线,是它区别于OBS、streamlink等纯录制工具的特点。“虚拟录制”功能用于处理已有视频也很有创意。
软件在本地运行,录制和渲染的视频文件都保存在你的电脑硬盘里。只有在你主动开启并正确配置“自动上传”功能后,视频才会被发送到你指定的视频平台。整个过程没有中间服务器介入。
对于有基本计算机操作经验的用户来说,上手不难。主要的学习门槛在于初次配置YAML文件,需要对照文档理解各项参数的含义。一旦配置完成,后续使用非常简单,基本是“一键挂机”。
资源占用主要取决于录制和渲染任务。在“只录制不渲染”模式下,软件仅监听直播状态和下载数据,CPU和内存占用非常低。在进行视频渲染(压制弹幕)时,CPU或GPU占用会显著升高,但渲染在后台进行,不影响日常轻度使用。
软件基于Python,理论上支持Windows、macOS和Linux。官方发布版提供Windows可执行文件,Linux和macOS用户需要从源码运行或自行打包。
这是因为系统没有安装FFmpeg或没有正确配置环境变量。你需要先去FFmpeg官网下载对应系统的程序,并将bin文件夹的路径添加到系统的环境变量PATH中,重启DanmakuRender即可。
V5是一次重大重构,支持了更多直播平台(如抖音、TikTok),采用了更灵活的配置结构,并引入了虚拟录制等新功能。V4和V5的配置文件不兼容,如果你从V4升级,需要重新根据V5的文档编写配置文件。