rhfbgfgfdg999999/3d-printer-live

What it does

This is a locally run 3D printer visualization for live streams. Viewer comments, likes, gifts and follows in a Douyin, Kuaishou or TikTok room trigger avatar models that are printed layer by layer in a Three.js scene, then scored and moved onto a conveyor. It ships with a rules panel, print log, camera presets, quality presets and bilingual Chinese/English pages; the English version is aimed at TikTok streams. Avatars come from the viewer's live-room profile and are cached locally so returning viewers appear quickly.

A separate bridge process reads the comment stream from a logged-in browser window and sends events to the printer page over a local WebSocket. The README describes three avatar sources: direct decoding of live-room protocol frames, page-level collection, and profile-card fallback, with a generated colored-initial avatar as the last resort.

Quick start

1. Install Python. For the desktop WebView2 edition also install Node.js, pywebview and the WebView2 Runtime.
2. Double-click start.bat, then open http://127.0.0.1:8080 in a browser. Do not open the HTML file directly, because the browser blocks local ES modules.
3. The page loads eight test avatars and prints them without a live room, so you can check the scene first.
4. For a real room, double-click start-all.bat. It starts the print service and opens a Chrome live-room window where you scan the QR code to log in, plus the printer app. Alternatively run start.bat and start-bridge.bat separately.
5. Enter the room number or full room URL in the "直播连接" panel. The page connects to ws://127.0.0.1:8765 and shows the bridge connection and room number when ready.

A full beginner video walkthrough is available on Bilibili. The app also links its feature page and guide from the print bench, and the README points to a step-by-step tutorial at http://127.0.0.1:8080/guide.html after the server is running.

Usage constraints

• Python is required; the WebView2 desktop edition additionally needs Node.js, pywebview and the WebView2 Runtime.
• The page must be served over HTTP; double-clicking the HTML will not work.
• Before first use of the new WebView2 build, close old ServerGuard, BridgeGuard and any old bridge to avoid port conflicts. The new window uses a separate login profile, so you need to log in again.
• The bridge reads public live-room comments only and does not log in on your behalf, send comments or send gifts; the live-room window is where you log in.
• Capturing is tied to the bridge browser window; closing it stops collection. Only comments that appear after attachment are printed; earlier history is skipped.
• Scores shown are entertainment random values, not a real rating.
• The project is MIT licensed.

Customization notice

The README advertises the software as free and open source but also offers paid customization (600–1800 yuan) and lists personal WeChat contacts. If you only want to use the open-source program, no payment is required.

HotRepo's take

On 2026-11-02 the repository appeared on HotRepo's new-project list for JavaScript with 111 stars and 52 forks, gaining 8 stars in the roughly two-hour window from 07:45 to 09:45 UTC. That is a fast early rally, but the snapshot covers only one list entry and one short window, so it does not establish a longer trend. The fork count is high relative to the star count, which suggests people are copying or building on the project rather than only starring it; the README's paid customization offer is a plausible reason some users fork it. The project's practical value is the live-room-to-3D scene bridge, which is described in more concrete detail than the visual layer.