WebMusicWidget
WebMusicWidget is a web widget as “Now Playing” indicator for streaming over platforms like TikTok LIVE Studio, Streamlab or OBS Studio with multiple design style. It works over media hooking and multiple Node.js functions. Hosted over Cloudflare Tunnel for streaming platform that requires a TLD (Top-Level Domain) with HTTPS
Features
- Multi-Source Support: Captures metadata from native desktop apps (Spotify, etc.) and browsers via WebNowPlaying.
- Low Latency: Uses WebSockets for instantaneous UI updates.
- Dynamic UI: Features modern tech-grid designs, obtained from
%APPDATA%\TikTok LIVE Studio\overlay\Theme Name\source-alert\alert_background_2.png. - Stream Ready: Built-in support for Cloudflare Tunneling to meet HTTPS/TLD requirements.
Quick Start
- Install Dependencies:
npm install - Compile Native Adapter:
compile.bat - Run Server:
start.bat
The overlay will be accessible at http://localhost:8080.
Integration
Browser Support
Install the WebNowPlaying extension and add a custom adapter: ws://127.0.0.1:8974.
Streaming Platform (OBS Studio, TikTok LIVE Studio,…)
[!NOTE] You have to re-enter a new link after the tunnel expire/you close the terminal window
After you run start.bat, wait for a few seconds for it to request for a HTTPS domain. It will automatically copy the generated link
Step 1: Click the + button inside the Sources panel.
Step 2 — Select Browser or Link
Step 3: Paste the automatically copied tunnel URL into the browser source field.
[!TIP] It is recommended to set a custom resolution by 520x140 as it was the default fixed resolution.