Start the SSE server

python sse_server.py

Sounds play automatically when the bot connects for testing purposes. User must click/scroll on the overlay page for audio to play (browser requirement)

From root

python .\sse_server.py

then go to

http://localhost:8000/sounds_overlay

then start your bot as seen in the example bot in root

File Structure

├── sse_server.py                    # Web server and SSE endpoint
├── twitchio_bot.py                  # Base bot class with sound functionality
├── connection_manager.py            # Manages SSE client connections
├── .env                             # Environment variables (create this)
├── utils/
│   ├── data_models.py              # dataclass
│   └── audio_to_base64.py          # Audio file conversion utilities
├── extensions/
│   ├── __init__.py
│   ├── browser_source/
│   │   ├── __init__.py
│   │   ├── sse.py                  # SSE endpoint logic
│   │   └── sounds.py               # Sound processing and broadcasting
│   └── client_files/
│       └── sounds/
│           ├── static/
│           │   ├── scripts.js      # Frontend JavaScript
│           │   └── styles.css      # Frontend styles
│           └── templates/
│               └── sound_overlay.html  # Browser overlay template