Flood-Tuber | Native PNGTuber Plugin 1.3.0

Bring your streams to life! Automatically animate your avatar directly in OBS.

Flood Tuber is a lightweight, fully native OBS Studio plugin that detects your microphone's audio levels to animate your avatar with talking, blinking, and random action states. It adds dynamism to your content without the need for complex external software or heavy CPU usage.

OBS Studio Version Compatibility:
• OBS Studio 33.0.0 and newer: Download v1.2.0+ (latest release).
• OBS Studio 32.x and older: Please use v1.1.0.

Click to expand...

✨ Features

• ️ Audio Reactive: Automatically switches between Idle and Talking states based on your microphone input.
• ️ 3-Frame Talking Animation: Supports Talk A, Talk B, and Talk C frames for smoother, more natural mouth movements.
• Avatar Library: Built-in library system to easily load, save, and switch between different avatar presets (images + settings) with a single click.
• Auto-Blink: Brings your avatar to life with configurable automatic blinking intervals.
• ✨ Random Actions: Plays random action animations (like an emote or special pose) at set intervals to keep things fresh.
• Motion Effects:
  • Shake: Avatar vibrates/shakes when talking.
  • Bounce: Avatar bounces up and down when talking.
  • None: Static talking image.
• ️ Advanced Animations: Full support for APNG, WebP, and GIF formats!
  • Smart Detection: Automatically detects animated files even if the file extensions are incorrect (e.g., an APNG saved as .png).
• ⚡ Talking Animation Speed: Control exactly how fast your avatar's mouth moves (frames/sec) with a dedicated slider.
• ↔️ Mirror Mode: Flip your avatar horizontally with a single checkbox.
• Multi-Language Support: Native UI localized in English, Turkish, and French!
• ️ Custom Settings per Avatar: Each avatar in the library can have its own settings.ini to define specific sensitivities, speeds, and timings.

⚙️ Installation
You can download the latest version from the download button above or via GitHub Releases.

Option 1: Installer (Recommended)

1. Download FloodTuber-Installer-1.2.0.exe.
2. Run the installer.
   

   ⚠️ Note regarding "Windows protected your PC":
   Since this is a free, open-source project, it does not have an expensive code signing certificate. When you run the installer, Windows SmartScreen may show an "Unknown Publisher" warning. This is completely normal!
   - Click "More Info"
   - Click "Run Anyway"

   Click to expand...

3. Follow the setup wizard instructions. The installer automatically installs the plugin to the official OBS plugin directory (C:\ProgramData\obs-studio\plugins\flood-tuber) and cleans up legacy files from C:\Program Files\obs-studio.

Option 2: Portable (Manual)

1. Download FloodTuber-Portable-v1.2.0.zip.
2. Extract the flood-tuber folder from the archive directly into your OBS plugins directory:[BR]C:\ProgramData\obs-studio\plugins\
3. (<If upgrading manually from v1.1.0 or older>) Delete the old C:\Program Files\obs-studio\obs-plugins\64bit\flood-tuber.dll file and C:\Program Files\obs-studio\data\obs-plugins\flood-tuber folder so OBS does not load the outdated version.
4. Restart OBS Studio.

Usage

1. Add a new "Flood Tuber Avatar" source to your scene.
2. Under properties, select your microphone from the Audio Source list.
3. Load an Avatar: Go to the "Avatar Library", select a preset, and click "Load & Apply Avatar".
4. Adjust the Threshold slider to match your speaking volume.
5. Customize your Motion Type (Shake/Bounce) and enjoy!

Creating Your Own Avatar

1. Click "Open Avatars Folder" in the source properties (opens C:\ProgramData\obs-studio\plugins\flood-tuber\data\avatars).
2. Create a new folder with your avatar's name (e.g., My Cool Avatar).
3. Place your images inside and name them correctly: idle.png, talk_a.png, talk_b.png, talk_c.png, blink.png, action.png.
4. (Optional) Copy a settings.ini from another avatar folder to fine-tune the default settings for your new character.
5. Go back to OBS, select your new folder from the library list, and click Load!

❤️ Special Thanks & Contributors
Huge thanks to the awesome community members who contributed to this project:
• @IamS3pt1m — For PR #13 (OBS 33 image API update).
• @Poste2Travail (Mardios Lambda) — For the button2 deprecation fixes, French localization, and testing.
• @shinyflvre — For standard OBS ProgramData plugin structure suggestions.

---

AI Disclosure:
Artificial Intelligence tools were used as an assistant to help structure boilerplate code and draft documentation during the development of this plugin. Additionally, the demo avatar assets included in the release were generated using AI art tools. All core logic, OBS API integrations, and community updates are manually reviewed and maintained.

Click to expand...

---

Developed with ❤️ by justflood.
This project is Open Source and licensed under the GNU General Public License v2.0 (GPLv2).