This is an early version — feedback is welcome!

SpeakForge is a standalone desktop tool that lets you create fully customizable Discord speaker overlays for OBS.

It connects directly to Discord StreamKit and transforms voice activity into animated, per-user visuals — perfect for streamers, VTubers, podcasts, and gaming content.

🎯 Features

• 🎤 Real-time voice detection from Discord StreamKit
• 🧑‍🤝‍🧑 Multiple users support with individual settings
• 🖼 Custom avatars for idle and speaking states
• 📏 Adjustable size, scale, and bounce animation
• 🎚 Optional grayscale and visual effects
• 🎮 Global hotkeys to toggle users on/off
• 👁 Auto-hide users when they leave the voice channel
• 🧩 Simple setup with one OBS browser source per user
• ⚙️ Built-in HUD configuration panel
• 🐞 Debug panel to monitor live voice detection

🧪 How it works

1. Generate your Discord overlay via StreamKit
2. Paste the URL into SpeakForge
3. Create users and match them to Discord names
4. Add the generated overlay URL into OBS
5. Done — your avatars now react in real time

🖥 OBS Setup

Use a browser source like:

http://127.0.0.1:3000/overlay/your-user

Each user gets their own overlay URL.

⚠️ Requirements

• Discord (voice chat)
• OBS Studio
• SpeakForge must be running in the background

💡 Use Cases

• 🎮 Streaming with friends
• 🎙 Podcasts and group recordings
• 🧑‍🎤 VTubing setups
• 🎥 Content creation with voice reactions

❤️ Made by

Kärntnernoob

📖 How to Use SpeakForge

🚀 1. Start SpeakForge

• Launch the SpeakForge application
• The main HUD will open automatically

🔗 2. Get your Discord Overlay URL

1. Open:
   👉 https://streamkit.discord.com/overlay

📥 3. Paste the URL into SpeakForge

• In SpeakForge:
  • click the ⚙️ Settings icon
  • paste your StreamKit URL
  • click Save

👤 4. Create and configure users

1. Click Add User
2. Select the user from the list
3. Configure:

Required:

• Discord Match Name
  → must match the name shown in the StreamKit overlay exactly

Optional:

• Display Name
• Idle Image
• Speaking Image

🎨 5. Customize appearance

Per user you can adjust:

• Width / Height
• Bounce Scale (animation when speaking)
• Idle Scale / Speaking Scale
• Grayscale effects
• Visibility toggle (👁 button)
• Hotkey (optional)

👁 6. Visibility behavior

SpeakForge automatically handles:

• ❌ User not in voice channel → avatar hidden
• 😐 User idle → idle image
• 🎤 User speaking → animated speaking image

🎮 7. (Optional) Set a Hotkey

• Click Wait for hotkey
• Press your desired key combination
• Use Reset to remove it

👉 Hotkeys toggle the user visibility globally

🧩 8. Add to OBS

1. Open OBS
2. Add a Browser Source
3. Use this URL:

<u><a href="http://127.0.0.1:3000/overlay/your-user">http://127.0.0.1:3000/overlay/your-user</a>
</u>

http://127.0.0.1:3000/overlay/default