1. Open the Dashboard
Launch StatusForge and make sure the engine is running (top of the Dashboard shows the engine status). The overlay picker lives on the Dashboard — pick from four layouts:
- Horizontal Left / Horizontal Right — game cover + title, anchored to one side
- Vertical — tall layout for side-panel placement
- Logo Only — just the game's logo, no cover art or text
2. Copy the widget URL
Each overlay is served locally by StatusForge itself — no external hosting, no account needed. The URL follows this pattern:
http://127.0.0.1:53735/forge-widget/<your-widget-token>/<layout>.html
Your widget token is unique per install and shown (partially masked) on the Dashboard. Copying a layout from the picker copies the full URL with the token already filled in — you shouldn't need to type it by hand.
3. Add it as a Browser Source
- In OBS/Streamlabs, add a new source → Browser
- Paste the widget URL into the URL field
- Set the width/height to match your chosen layout (table below)
- Leave Shutdown source when not visible unchecked, so it keeps polling in the background
| Layout | Width | Height |
|---|
| Horizontal Left / Right | 850 | 480 |
| Vertical | 360 | 620 |
| Logo Only | 560 | 280 |
ℹ️
The overlay fades in automatically when a game is detected and fades out after your configured fade timer (Settings → Detection Engine). No game running = no overlay on screen, so it's safe to leave the Browser Source active for your whole stream.
Troubleshooting
- Blank overlay: confirm the engine is running (Dashboard status) and that
127.0.0.1:53735 isn't blocked by a firewall rule.
- Wrong game showing: check Settings → Detection Engine for the scan interval/grace period — a very short grace period can flicker between games during alt-tabbing.
The Oddity Forge