danmaku.rocks

Twitch / YouTube danmaku player & overlay service.

Player

Twitch player:

https://danmaku.rocks/{CHANNEL}

YouTube player (watch mode):

https://danmaku.rocks/watch.html?provider=youtube&v={YOUTUBE_VIDEO_ID}

Overlay

Can be used in OBS BrowserSource. (需手動確認)

Twitch overlay:

https://danmaku.rocks/overlay/{CHANNEL}

YouTube overlay:

https://danmaku.rocks/overlay/?provider=youtube&v={YOUTUBE_VIDEO_ID}

URL Parameters

Name	Description
provider	Chat source provider. twitch (default) or youtube
channel (c)	Twitch channel name. Optional if channel is provided in path
video (v)	YouTube video id (required when provider=youtube)
ytproxy (yp)	YouTube SSE proxy base URL (default: https://cloud.pymaster.tw/ndapi)
shownick	Show user nickname (value: 0 or 1)
showbadges	Show user badges (value: 0 or 1)
speed	Danmaku speed (default value: 100)
theme	Optimize danmaku text color for light or dark background
reverse	Invert danmaku stream's vertical starting point (value: 0(from top) or 1(from bottom)
rect	Danmaku streams's vertical range in screen percentage (default value: 0,100)
nochat	Do not render chat iframe (value: 0 or 1)
showstream	Enable stream iframe rendering (value: 0 or 1, watch mode enables this automatically)

Parameter Examples (with overlay)

Example URL availability on production deployment is 需手動確認.

• Basic
• Show Nicknames
• Show Badges
• Invert Danmaku vertical starting point
• Show Danmaku between specified vertical range
• YouTube overlay

Develop

Install

Clone this repo, then

# get submodules
git submodule update --init --recursive

yarn install

Use Node.js 22 or newer (see engines in package.json).

For YouTube SSE testing, also install dependencies in your local SSE proxy project:

npm install

Dev server

yarn start

# then open the local URL printed in the terminal (Vite default: http://localhost:5173)

For YouTube mode (local), run proxy server in another terminal:

BASE_PATH="" npm run server

Then open:

http://localhost:5173/watch.html?provider=youtube&v=AO8yfw84kh4&showstream=1&shownick=1&showbadges=1&ytproxy=http://localhost:3000

If Vite chose another port (for example when 5173 is busy), swap the host/port to match the dev server URL from your terminal.

Deploy

# static output goes to docs/ (vite.config.js build.outDir)
yarn build

# optional: commit built assets for a static host that reads /docs from the repo
git add -u docs/
git push

Pushes to master run .github/workflows/pages.yml: checkout with submodules, yarn install --frozen-lockfile, yarn build, then deploy the docs/ artifact to GitHub Pages.