Quote from
Mrr Zed0 on March 26, 2026, 4:42 pm
🏆 StreamTracker (OBS Achievement Overlay)
A dynamic, automated Steam Achievement Tracker for OBS Studio. It runs locally on your PC, scans your active game, and auto-themes the overlay to match the game’s artwork.
🎥 Installation Video
🎉 Major update with real-time features!
- 🌐 WebSocket Real-Time Updates — Instant achievement notifications via WebSocket (no more polling!)
- 🤖 Streamer.bot Integration — Chat commands
!progress, !hunter, !recent + auto-announce rare achievements
- 🔊 Rarity-Based Sound Alerts — Different sounds for Common, Uncommon, Rare, Ultra Rare, and Legendary achievements
- ⚡ Instant Achievement Detection — New unlocks broadcast immediately to overlay
- 🎮 Game Change Detection — Auto-switches when you change games
- 🦎 Chameleon Theme: Automatically detects your game via Steam and changes overlay colors to match the official artwork.
- 🎯 Hunter Mode: Pin a specific locked achievement to the screen to show chat what you are grinding for.
- 📱 Vertical Mode: Dedicated 9:16 layout for TikTok Live and YouTube Shorts.
- 🎛️ Native OBS Dock: Control the tracker, reset sessions, and adjust volume directly inside OBS.
- ⏱️ Session Tracking: Live timer + “Session Counter” (shows
+X unlocks) to track your progress during the current stream.
- 💤 Smart Standby: Switches to a sleek “Profile Card” showing your avatar and stats when no game is running.
- ⚡ Lightweight: Written in Python, runs locally, uses minimal resources.
New in v1.7 — Streamer.bot Integration 🤖
Connect to Streamer.bot for powerful chat integration:
| Command |
Description |
!progress |
Shows current game and achievement progress |
!hunter |
Shows your pinned achievement target |
!recent |
Shows last 3 unlocked achievements |
Auto-announcements: Rare achievements (< 5% global unlock rate) are automatically announced in chat!
New in v1.7 — Rarity Sound Tiers 🔊
Different sounds play based on achievement rarity:
| Tier |
Unlock Rate |
Color |
Volume |
| Legendary |
< 1% |
🟡 Gold |
120% |
| Ultra Rare |
1-5% |
🟠 Orange Red |
110% |
| Rare |
5-20% |
🟣 Purple |
100% |
| Uncommon |
20-50% |
🔵 Blue |
90% |
| Common |
> 50% |
⚪ Gray |
80% |
Standard Overlay
Vertical Mode
Control Dock
You can download the latest pre-compiled .exe from the Releases Page.
- ✨ WebSocket real-time updates
- 🤖 Streamer.bot chat integration
- 🔊 Rarity-based sound alerts
- ⚡ Instant achievement detection
This project is free and open source. If it helps your stream, consider buying me a coffee!
- Download
StreamTracker_v1.7.zip from Releases.
- Unzip the folder to a permanent location (e.g., Documents/StreamTools).
- Run
StreamTracker.exe.
- Enter your Steam API Key and ID in the Setup Wizard.
- Add to OBS:
- Add a Browser Source.
- URL:
http://localhost:5000
- Width:
600 | Height: 250
- URL:
http://localhost:5000/?mode=vertical
- Dimensions: Width
350 | Height 600
🎛️ Adding the Control Dock
- In OBS, go to Docks -> Custom Browser Docks.
- Name:
Tracker Control
- URL:
http://localhost:5000/dock
- Click Apply and snap the window into your layout.
- Open Streamer.bot
- Go to Actions → Import → Generic Webhook
- Set URL:
http://localhost:5000/webhook/streamerbot
- Enable Chat Message events
- Test with
!progress in chat!
See INTEGRATION.md for advanced setup.
If you prefer running the Python script directly:
- Install Python 3.x
- Install Dependencies:
pip install -r requirements.txt
- Run the App:
# Install PyInstaller
pip install pyinstaller
# Build executable
build_windows.bat
# or
pyinstaller StreamTracker.spec
GitHub Actions (Automated)
Push a version tag to trigger automatic builds:
git tag v1.6.0
git push origin v1.6.0
The build will appear on the Releases page.
| Endpoint |
Description |
GET / |
Main overlay |
GET /dock |
Control dock |
GET /data |
Achievement data (JSON) |
POST /webhook/streamerbot |
Streamer.bot integration |
WS localhost:8765 |
WebSocket for real-time updates |
Feel free to submit Pull Requests or open Issues if you find bugs!
See RELEASE_CHECKLIST.md for release process.
Download Link: https://github.com/ZakyPew/StreamTracker
🏆 StreamTracker (OBS Achievement Overlay)
A dynamic, automated Steam Achievement Tracker for OBS Studio. It runs locally on your PC, scans your active game, and auto-themes the overlay to match the game’s artwork.
🎥 Installation Video
🎉 Major update with real-time features!
- 🌐 WebSocket Real-Time Updates — Instant achievement notifications via WebSocket (no more polling!)
- 🤖 Streamer.bot Integration — Chat commands
!progress, !hunter, !recent + auto-announce rare achievements
- 🔊 Rarity-Based Sound Alerts — Different sounds for Common, Uncommon, Rare, Ultra Rare, and Legendary achievements
- ⚡ Instant Achievement Detection — New unlocks broadcast immediately to overlay
- 🎮 Game Change Detection — Auto-switches when you change games
- 🦎 Chameleon Theme: Automatically detects your game via Steam and changes overlay colors to match the official artwork.
- 🎯 Hunter Mode: Pin a specific locked achievement to the screen to show chat what you are grinding for.
- 📱 Vertical Mode: Dedicated 9:16 layout for TikTok Live and YouTube Shorts.
- 🎛️ Native OBS Dock: Control the tracker, reset sessions, and adjust volume directly inside OBS.
- ⏱️ Session Tracking: Live timer + “Session Counter” (shows
+X unlocks) to track your progress during the current stream.
- 💤 Smart Standby: Switches to a sleek “Profile Card” showing your avatar and stats when no game is running.
- ⚡ Lightweight: Written in Python, runs locally, uses minimal resources.
New in v1.7 — Streamer.bot Integration 🤖
Connect to Streamer.bot for powerful chat integration:
| Command |
Description |
!progress |
Shows current game and achievement progress |
!hunter |
Shows your pinned achievement target |
!recent |
Shows last 3 unlocked achievements |
Auto-announcements: Rare achievements (< 5% global unlock rate) are automatically announced in chat!
New in v1.7 — Rarity Sound Tiers 🔊
Different sounds play based on achievement rarity:
| Tier |
Unlock Rate |
Color |
Volume |
| Legendary |
< 1% |
🟡 Gold |
120% |
| Ultra Rare |
1-5% |
🟠 Orange Red |
110% |
| Rare |
5-20% |
🟣 Purple |
100% |
| Uncommon |
20-50% |
🔵 Blue |
90% |
| Common |
> 50% |
⚪ Gray |
80% |
Standard Overlay
Vertical Mode
Control Dock
You can download the latest pre-compiled .exe from the Releases Page.
- ✨ WebSocket real-time updates
- 🤖 Streamer.bot chat integration
- 🔊 Rarity-based sound alerts
- ⚡ Instant achievement detection
This project is free and open source. If it helps your stream, consider buying me a coffee!
- Download
StreamTracker_v1.7.zip from Releases.
- Unzip the folder to a permanent location (e.g., Documents/StreamTools).
- Run
StreamTracker.exe.
- Enter your Steam API Key and ID in the Setup Wizard.
- Add to OBS:
- Add a Browser Source.
- URL:
http://localhost:5000
- Width:
600 | Height: 250
- URL:
http://localhost:5000/?mode=vertical
- Dimensions: Width
350 | Height 600
🎛️ Adding the Control Dock
- In OBS, go to Docks -> Custom Browser Docks.
- Name:
Tracker Control
- URL:
http://localhost:5000/dock
- Click Apply and snap the window into your layout.
- Open Streamer.bot
- Go to Actions → Import → Generic Webhook
- Set URL:
http://localhost:5000/webhook/streamerbot
- Enable Chat Message events
- Test with
!progress in chat!
See INTEGRATION.md for advanced setup.
If you prefer running the Python script directly:
- Install Python 3.x
- Install Dependencies:
pip install -r requirements.txt
- Run the App:
# Install PyInstaller
pip install pyinstaller
# Build executable
build_windows.bat
# or
pyinstaller StreamTracker.spec
GitHub Actions (Automated)
Push a version tag to trigger automatic builds:
git tag v1.6.0
git push origin v1.6.0
The build will appear on the Releases page.
| Endpoint |
Description |
GET / |
Main overlay |
GET /dock |
Control dock |
GET /data |
Achievement data (JSON) |
POST /webhook/streamerbot |
Streamer.bot integration |
WS localhost:8765 |
WebSocket for real-time updates |
Feel free to submit Pull Requests or open Issues if you find bugs!
See RELEASE_CHECKLIST.md for release process.
Download Link: https://github.com/ZakyPew/StreamTracker
