Setup Guide

Get ThingTuber running on your stream in under 5 minutes.

Quick Start (Hosted Version)

1 Go to /app and allow camera access
2 Pick your avatar and start the camera
3 Add the URL as Browser Source in OBS

Platform Setup

OBS Studio

Most Popular
  1. Start ThingTuber

    Run the server and open the app in your browser. Set up your avatar and start the camera.

  2. Add Browser Source

    In OBS, click the + under Sources → Browser

  3. Configure the Source

    URL: http://localhost:8080

    Width: 800

    Height: 600

    Custom CSS: Leave blank or add body { background: transparent; }

  4. Position Your Avatar

    Resize and position the source where you want it on screen. Right-click → Transform → Edit Transform for precise control.

  5. Optional: Chroma Key

    If using a solid color background, add a Chroma Key filter to remove it and show only your avatar.

Streamlabs Desktop

  1. Start ThingTuber

    Make sure the server is running and your avatar is set up.

  2. Add Browser Source

    Click + in Sources panel → Browser Source

  3. Enter URL

    URL: http://localhost:8080

    Width: 800

    Height: 600

  4. Adjust & Stream

    Position your avatar and you're ready to go!

Discord Screen Share

  1. Open ThingTuber in its own window

    Keep the browser window with your avatar separate.

  2. Share Application Window

    In Discord video call, click Share Screen → Applications → Select your ThingTuber browser window

  3. That's it!

    Your friends will see your avatar instead of your face.

Zoom / Google Meet

  1. Install OBS Virtual Camera

    OBS has a built-in virtual camera feature. Start OBS with your ThingTuber browser source.

  2. Start Virtual Camera

    In OBS, click "Start Virtual Camera" in the Controls panel.

  3. Select OBS Camera in Zoom/Meet

    Go to video settings and select "OBS Virtual Camera" as your camera source.

Pro Tips

🎨 Transparent Background

Set the background color to a solid green/blue, then use Chroma Key in OBS to make it transparent.

🔒 Privacy Mode

Enable privacy mode in the app to blur your webcam feed - only the avatar tracking data is used.

⚡ Performance

Close other browser tabs. ThingTuber runs best when it has full GPU access.

🖼️ Custom Models

Export any 3D model as .glb format from Blender or online converters and use it as your avatar.

💡 Lighting

Good lighting on your face = better tracking. Sit facing a window or use a ring light.

📐 Calibration

Use the calibration tools in the app to fine-tune where your eyes and mouth appear on the model.

Troubleshooting

Camera not detected?

Make sure you've granted camera permissions in your browser. Check that no other app is using your webcam. Try refreshing the page.

Avatar not moving?

Click "Start Camera" in the app. Make sure your face is visible and well-lit. The face detection needs clear visibility of your features.

OBS showing black screen?

Make sure the server is running (node server.js). Try refreshing the browser source in OBS (right-click → Refresh).

Laggy or choppy?

Close other browser tabs. Lower your stream resolution. Make sure hardware acceleration is enabled in your browser.

Model not loading?

Check that the .glb file is in the correct folder. Try one of the included sample models first.

Ready to Stream?

Launch ThingTuber