Skip to content

🎭 PNG Tuber ​

A virtual avatar that reacts to your voice, perfect for faceless streaming or V-Tuber style content.


Overview ​

PNG Tuber displays an animated avatar that:

  • Detects when you're speaking
  • Switches between idle and speaking images
  • Adds personality without showing your face
  • Works with Discord voice detection

How It Works ​

  1. Connect your Discord account
  2. Select or upload avatar images
  3. Join a Discord voice channel
  4. Your avatar animates when you speak!

Requirements ​

  • Discord account
  • Discord voice channel
  • Microphone
  • Two avatar images (idle and speaking)

Settings ​

Avatar Selection ​

SettingDescriptionDefault
Selected AvatarPreset or custom avataravatar1
Custom Idle ImageYour own idle image URL(empty)
Custom Speaking ImageYour own speaking image URL(empty)

Transition Settings ​

SettingDescriptionDefault
Transition TypeHow images swapCrossfade
Transition SpeedSwap duration (ms)150

Animation Settings ​

SettingDescriptionDefault
Speaking AnimationMovement while talkingWobble

Animation options:

  • None: Static image
  • Single Bounce: One bounce when speaking starts
  • Continuous Bounce: Keeps bouncing while speaking
  • Breathe: Gentle breathing motion
  • Wobble: Side-to-side movement
  • Pulse: Size pulsing
  • Head Bob: Up-down motion

Visual Settings ​

SettingDescriptionDefault
Dim When SilentDarken when not speakingOn
ScaleAvatar size (50-200%)100
Offset XHorizontal position0
Offset YVertical position0

Setup Instructions ​

Step 1: Connect Discord ​

  1. Go to Utilities β†’ PNG Tuber in your dashboard
  2. Click Connect Discord
  3. Authorize Citrus to access your Discord
  4. Return to the dashboard

Step 2: Choose Your Avatar ​

Use a Preset:

  1. Select from available preset avatars
  2. Preview appears immediately

Use Custom Images:

  1. Upload your idle image
  2. Upload your speaking image
  3. Images should be the same size
  4. PNG format with transparency recommended

Step 3: Configure Animations ​

  1. Select your transition type
  2. Choose a speaking animation
  3. Adjust transition speed
  4. Enable/disable dim when silent

Step 4: Add Overlay to OBS ​

  1. Copy the PNG Tuber overlay URL
  2. In OBS, add a Browser Source
  3. Paste the URL
  4. Set dimensions: 500 x 500 (or match your image)
  5. Position your avatar

Step 5: Activate ​

  1. Join a Discord voice channel
  2. Your avatar will detect your voice
  3. Test by speakingβ€”avatar should animate!

Creating Custom Avatars ​

Image Requirements ​

  • Format: PNG (transparent background)
  • Size: Same dimensions for both images
  • Resolution: 500x500 to 1000x1000 recommended
  • Style: Clear difference between idle and speaking

Tips for Good Avatars ​

  1. Clear Difference: Speaking should look distinct from idle
  2. Transparent Background: Easier to overlay
  3. Consistent Style: Both images should match
  4. Simple Animation: Don't overcomplicate

Common Avatar Styles ​

StyleDescription
Open/Closed MouthMost commonβ€”mouth changes
Full ExpressionFace changes entirely
AbstractNon-human representations
Logo-BasedYour brand animates

Discord Integration ​

Why Discord? ​

Discord's voice activity detection is:

  • Reliable and accurate
  • Low latency
  • Works across platforms
  • Doesn't require additional software

How to Use ​

  1. Open Discord on your computer
  2. Join any voice channel
  3. Make sure your mic is working in Discord
  4. The overlay detects your voice activity

Permissions Needed ​

  • Voice activity status
  • User profile (for connection)

Troubleshooting ​

Avatar Not Animating ​

IssueSolution
Not responding to voiceCheck Discord voice channel connection
Discord not connectedReconnect Discord in settings
Mic not workingTest mic in Discord

Display Issues ​

IssueSolution
Images not showingCheck image URLs are valid
Wrong sizeAdjust scale setting
Wrong positionModify offset X/Y

Animation Issues ​

IssueSolution
Jerky transitionsIncrease transition speed
No animationSelect animation other than "None"
Too much movementChoose subtler animation

Best Practices ​

  1. Test Before Streaming: Verify everything works
  2. Use Clear Differences: Make idle/speaking distinct
  3. Match Your Brand: Avatar should fit your style
  4. Keep It Simple: Subtle animations often work best
  5. Consider Accessibility: Ensure avatar doesn't distract

FAQ ​

Q: Can I use this without Discord? A: Currently Discord is required for voice detection.

Q: What image formats are supported? A: PNG is recommended; JPG and GIF also work.

Q: Can I have more than two images? A: Currently only idle and speaking; more expressions coming soon.

Q: Does it work with voice changers? A: Yes, as long as Discord detects your voice.

Q: Can I use animated GIFs? A: Yes, but transitions may be less smooth.

Q: Do I need to be in a Discord call? A: You need to be in a voice channel, but not necessarily with others.

The all-in-one streaming platform.