QiuranQAQ GitHub avatar

DouyuLive-Danmu-Merge

QiuranQAQ

A single-file Cloudflare Worker that provides a real-time Douyu live stream danmaku overlay with smart merging, TTS, and OBS support, deployable with zero server cost.

Stars

14

7-day growth

No data

Forks

1

Open issues

0

License

MIT

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines ultra-simple deployment on Cloudflare's free tier with a feature-rich danmaku client that includes intelligent combo merging, voice reading, and full OBS overlay compatibility, all in one self-contained script.

Who it is for

  • Douyu streamers who want a free, real-time danmaku overlay for their broadcasts
  • OBS users looking for a transparent, customizable danmaku source
  • Developers seeking a minimal cloud-deployable WebSocket-based danmaku solution
  • Chinese live streaming communities needing a lightweight danmaku monitoring tool

Use cases

  • Display danmaku on a separate monitor or OBS preview during a Douyu stream
  • Monitor multiple chat rooms by passing room ID as URL parameter
  • Analyze viewer engagement by reviewing combo and user history features
  • Enable voice announcement of danmaku and gifts for accessibility

Strengths

  • Zero-intermediary WebSocket connection from browser to Douyu servers, saving Worker bandwidth
  • Smart danmaku combo merging with color-coded tiers and pinned highlights for high-frequency messages
  • One-click deploy via Cloudflare Workers or Pages, no server management needed
  • Built-in TTS, user history lookup, and flexible OBS integration with transparent background

Considerations

  • workers.dev domain is often blocked in China, requiring a custom domain for reliable access
  • Limited to the Douyu platform; no support for other streaming services
  • No authentication or moderation controls for restricting user messages

README quick start

斗鱼弹幕在线助手 - Cloudflare Worker 极简部署版

基于原生 JavaScript 与 WebSocket 直连技术实现的斗鱼直播弹幕在线助手。该版本专为 Cloudflare Workers 设计,采用单文件部署方式,无需复杂的服务器配置,一键即可拥有专属的弹幕监控网页与 OBS 串流看板。 100% free and open-source for the community。

[!NOTE] 本项目由 DouyuEx 弹幕引擎驱动,由超限魔改优化。前端采用现代玻璃拟态(Glassmorphism)暗黑风设计,配合优雅的霓虹背景斑块及平滑过渡动画,给您极致的视觉与操作体验。


🔗 预览地址

https://danmu-d8y.pages.dev/

🖼️ 预览截图

✨ 核心特性

  • 零中转直连:浏览器端直接通过 WebSocket 建立与斗鱼弹幕服务器(wss://danmuproxy.douyu.com)的物理连接,Cloudflare Worker 仅负责分发前端静态页面,安全、快速且不占用 Worker 额度或服务器带宽。
  • 🔄 智能弹幕合并(Combo):在设定的时间窗口内,自动对相同字符但不同重复字数的刷屏弹幕进行合并。
    • 热度分级:根据合并数量自动调整徽章颜色(Tier 1: 灰色, Tier 2: 紫色加粗, Tier 3: 红色高亮并高能置顶)。
    • 点击展开:点击合并的弹幕,可动态展开子列表查看详细发送人员及精确时间。
  • 📌 高能弹幕置顶(Combo Pinned):合计数超过 10 次的“高能弹幕”将自动置顶于滚动区顶部专属区域,防止热门梗在飞速滚动的弹幕中被遗漏(上限 3 条,防占屏)。
  • 🗣️ 语音朗读 (TTS):内置文字转语音引擎,支持开启弹幕与礼物自动语音播报,自带队列缓冲与上限限流,防止朗读冲突与爆音。
  • 🔍 用户历史查询:点击任何弹幕中的用户昵称,即可一键在新标签页中查询该用户在直播间的历史弹幕数据。
  • 🎨 OBS 串流无缝兼容
    • 支持调节背景不透明度0%(全透明)。
    • 隐藏滚动条,专为 OBS 浏览器源设计,作为直播间弹幕看板极为清爽。
  • 🚀 极简启动与传参:支持 URL 参数直接读取房间号进行自动连接,例如 https://your-worker.workers.dev/?room=9999https://your-worker.workers.dev/9999

🛠️ Cloudflare 部署指南

本项目支持部署在 Cloudflare WorkersCloudflare Pages

选项一:部署至 Cloudflare Workers(控制台直接粘贴)

  1. 登录你的 Cloudflare Dashboard
  2. 点击左侧导航栏的 Workers & Pages (Workers 和 Pages) -> Create (创建) -> Create Worker (创建 Worker)
  3. 给你的 Worker 起一个名字(例如 douyu-danmaku),点击 Deploy (部署)
  4. 部署成功后,点击 Edit Code (编辑代码) 按钮。
  5. 清空编辑器中的默认代码,将本项目中的 cloudflare-worker.js 的全部内容复制并粘贴进去。
  6. 点击右上角的 Deploy (部署) 并发布。
  7. 绑定自定义域(建议):由于 *.workers.dev 域名在国内部分网络环境下访问受限,建议在 Worker 的 Settings (设置) -> Triggers (触发器) -> Custom Domains (自定义域) 中绑定您自己的域名,绑定后即可顺畅访问。

选项二:部署至 Cloudflare Pages(改名上传)

Cloudflare Pages 同样支持运行 Advanced Functions。你可以通过以下步骤极速部署:

  1. 本地新建一个空文件夹(例如 my-pages-app)。
  2. 将项目中的 cloudflare-worker.js 复制到该文件夹中,并重命名为 _worker.js
  3. 打开 Cloudflare Dashboard,选择 Workers & Pages -> Create -> Pages -> Upload assets (上传资源)
  4. 给你的 Pages 项目起一个名字

Description

斗鱼弹幕合并

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
tandpfun
Featured
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
Featured
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents
1,234