MotionBridgerRemix - 🚧 WIP 🚧

No ETA for Public Release Builds! - Sorry!

Free motion tracking bridge for PNGTubeRemix by MudkipWorld (AKA TheMime). Turn your PNG into a VTuber using webcam face, head, eye, and mouth tracking. — No Live2D or paid software required!

<img width="1280" height="640" alt="motionbridgerremix-banner2" src="https://github.com/user-attachments/assets/8437a6b6-abb5-44da-ab21-5ade21ca075e" />

---

🚧 This Project is Still: Work in Progress!

There is currently no ETA for a public release. - View the Planned Features

(Sorry, I'm rewriting the whole system.)

⚠️PLEASE SAVE A BACKUP OF YOUR RIG BEFORE RUNNING THIS TOOL!⚠️

🚨THIS TOOL WILL NOT WORK WITHOUT PNGTUBEREMIX!🚨

---

💎 Features

• Head, Eye, Eyebrow, Mouth Tracking
• Safety Locks
• Auto-Configure
• Support for Multiple Tracking API's (Main two: MediaPipe & OpenSeeFace)
• Actions Per Sprite part
• Flexible for Advanced Use
• Integration with StreamerBot
• Self-Check Diagnosis and Optimized
• 100% CONFIGURABLE & CUSTOMIZABLE
• OPEN SOURCE & FREE FOREVER!

👍 Compatibility

MBR is compatible with:

• Models with lots of individually moving parts
• States/Toggles, Assets, parent/children setups, Meshes, Static and Cycling/Animated Sprites
• ANY Camera (Webcam, Phone, Virtual, and Photography Cameras)
• Operating systems: Windows (Tested), Linux and MacOs (not tested but should work.)

---

Who is this tool for?

This tool is made for:

• Streamers, YouTubers and content creators
• PNGTubers & VTubers
• People interested in streaming, PNGTubing, VTubing, and rigging models.
• PNGTubeRemix Users

If you want a VTuber-style model but:

• don’t want to spend hundreds on rigging,
• feel overwhelmed by Live2D or VTube Studio,
• or just want something lightweight and flexible,

This tool is for you!

---

What do you need?

Just art of your character and PNGTubeRemix. That’s it!

• This tool was made for PNGTubeRemix, it WON'T work without it!
• Your PNG does not need to be specifically rigged for tracking — standard PNGTuber rigs work just fine.

• "Standard" meaning: Your PNGTuber Model's sprites/layers need to have simple names IF You want MBR to Auto-Configure everything. (Ex: Head = ✓ | 1234Head-with-Mask = ✘)<br>
• If you don't have simple names for your sprites/layers, you can enter advanced mode and confgirue things yourself in the UI.<br> ⚠️ Your sprites cannot have empty spaces in their names.

That said, rigging specifically for tracking will give better results.<br> If that's something you're interested in, check the tool's documentation to understand how you can get the best tracking results! :)

---

MotionBridgerRemix Editions

MotionBridgerRemix comes in two editions, depending on your experience level and needs.

Which one to use? (TL;DR)

• You don’t know how to code / want plug-and-play:
  → 📦 MotionBridgerRemix

• You know how to code in Python / want to customize things further:
  → 💻 MotionBridgeRemix-Dev-Pack

---

📦 Pre-Packaged Tool (MotionBridgerRemix) - Plug and Play!

Best for beginners and creators who want simplicity and to bring more life to their model.

What's included:

• All Dependencies bundled in one file.
• Simple workflow: install → configure → run

This version prioritizes ease of use over flexibility.

---

💻 Developer Pack (MotionBridgerRemix-Dev-Pack)

Best for advanced users, developers, or heavy customization.

What’s included:

• All source code used during development with comments to help guide you.
• MotionBridgerRemix.spec & requirements.txt for project details and dependencies
• Config file
• Debugging Tools

Use this version if:

• You want to modify or extend the code
• Your model rig is super advanced and requires further customization
• You’re comfortable writing or adjusting Python scripts

This version prioritizes flexibility over ease of use.<br> IMPORTANT: Read the documentation to learn how to install this edition!

---

📖 More Information

• Wiki & Documentation
• Rigging Guide
• Example Tracking Rig

Support:

• Bug Report
• Help & Support
• Feedback & Suggestion

---

🔒 Privacy & Usage

Please read the Privacy & Usage Notice before using this software.

---

Planned Features:

• Animation Presets
• ⭐ Profile System (Switching profiles for different models with different config values.)
• ⭐ My own version of T.I.T.S and other Integrations

---

🚫 No Generative-AI used

This software is 100% human-made.<br> I do not consent to the code of this software to be used to train AI models.