FunnyStreamTools is a lightweight, modular, and highly customizable streaming utility designed to add an aesthetic edge to your live broadcasts. It bridges your streaming platforms (Twitch, Discord, etc.) directly into a beautiful, terminal-inspired overlay for OBS.
- Terminal Aesthetic: Features a custom Windows-style CMD terminal overlay with real-time feedback, typewriter effects, and retro sounds.
- Ultimate Emote Integration: Full, built-in support for rendering custom and global emotes from Twitch, 7TV, BetterTTV (BTTV), and FrankerFaceZ (FFZ) inside the console chat overlay.
- Discord Integration: Real-time voice activity monitoring via local Discord RPC. No bot tokens required — it hooks directly into your local Discord client.
- Modular Architecture: Easily add new data providers (e.g., YouTube, Discord) and UI plugins without touching the core engine.
- Event-Driven: Built on an asynchronous event bus, ensuring high performance and low latency for your stream overlays.
- Python 3.10+
- Discord Desktop App (Must be running for voice integration)
- OBS Studio (To add the browser source overlays)
- Clone the repository:
git clone https://github.com/777Chara777/FunnyStreamTools.git
cd FunnyStreamTools
- Install dependencies:
uv sync
Start the core engine from the root directory:
uv run main.py
The server will start at http://127.0.0.1:8000.
- Open OBS Studio.
- Add a new Browser Source.
- Set the URL to the plugin endpoint:
- Chat Terminal:
http://127.0.0.1:8000/widget/commandchat - Discord Voice:
http://127.0.0.1:8000/widget/discordvoice
- Set the desired width and height (e.g.,
600x600or custom terminal dimensions). - Check "Refresh browser when scene becomes active" if desired.
- Providers: Listen to external APIs (Twitch/Discord) and push events to the
EventBus. - EventBus: A central hub that dispatches messages to the appropriate plugins.
- Plugins: WebSocket-based interfaces that render incoming events into web-based UI widgets with high-performance text and asset handling.
This project is open-source and free to use for your streaming needs.
Happy Streaming!