WebPNGTuber - Advanced PNG Tuber Editor

Русский | English

WebPNGTuber is an open-source application for creating and managing PNG Tuber models. It combines ease of use with advanced functionality, allowing you to build interactive avatars that react to your voice.

• 🎨 Multi-layer editor: Build complex models from PNG and GIF images.
• 🔊 Voice reactivity: 4 levels (silence, whisper, normal, shout).
• 👁️ Auto-blink: Realistic eye animation with adjustable frequency.
• 🌐 Built-in web server: Stream to OBS via http://localhost:6969.
• ⚙️ Advanced settings: Sensitivity, noise gate, effects.
• 💾 Slot system: Save up to 6 models with previews.
• 🌑 Idle mode: Auto‐dim avatar when inactive.
• 🌍 Multi‐language support: Russian and English (translated with neural network). You can add your own translation by placing a .json file in the locales folder – it will appear automatically in the language selector.

The "Customizable Slugcat PNGTuber Model" is provided by CurioKryptic (itch.io):
https://curiokryptic.itch.io/slugcat-pngtuber-model

Terms: the model is free to use; use it for testing.

1. Download the latest version from the Releases section.
2. Extract the archive to any folder.
3. Run WebPNGTuber.exe.

# Clone the repository
git clone https://github.com/core-dump-dev/WebPNGTuber.git
# Install dependencies
pip install -r requirements.txt
# Run the application
python main.py

• Windows 7 or newer
• For development: Python 3.7+

Pillow==10.3.0
numpy==1.26.4
sounddevice==0.4.6
Flask==3.0.3
requests==2.31.0

1. Start the web server inside the application.
2. In OBS, add a new "Browser" source.
3. Enter the URL: http://localhost:6969.
4. Set the size to 700x700 pixels.

1. Open the editor from the main window.
2. Import PNG/GIF images.
3. Arrange the layers in the desired order.
4. Adjust position, scale, and rotation of elements.
5. Group related elements (e.g., eyes).
6. Configure reactions for different volume levels.
7. Save the model to one of the 6 slots.

• Shake: Slight wobble on loud sounds.
• Bounce: Hopping animation.
• Pulse: Smooth size oscillation.
• Idle mode: Dimming when no sound is detected.

• Closing the main window while saving a model
  After saving in the editor, do not close it immediately – first check the model in the main window.

• Limited GIF support
  For animations, use optimized files.

• Sound reaction delay
  Make sure the correct audio device is selected in settings.

1. Start simple: Body + mouth + eyes.
2. Use transparency: PNGs with transparent backgrounds look better.
3. Optimise GIFs: Reduce the number of frames and colours.
4. Experiment: Try different reactions for different parts of the face.
5. Save often: Regularly save your work into different slots.