Supported Games
Segra currently supports automatic event tracking for:Counter-Strike 2
Tracked Events: Kills, DeathsUses CS2’s Game State Integration (GSI). Segra ships the required config and serves a local HTTP listener at
http://127.0.0.1:1340/League of Legends
Tracked Events: Kills, Assists, DeathsUses LoL’s local Live Client Data API on port 2999
PUBG: Battlegrounds
Tracked Events: Kills, DeathsReads PUBG’s local replay files (
%LocalAppData%/TslGame/Saved/Demos) after each matchRocket League
Tracked Events: Goals, AssistsUses on-screen OCR to detect goal and assist notifications
Dota 2
Tracked Events: Kills, Deaths, AssistsUses Dota 2’s Game State Integration (GSI) on a local HTTP listener at
http://127.0.0.1:1341/Minecraft
Tracked Events: DeathsTails the Minecraft Java
latest.log (vanilla at %AppData%/.minecraft/logs/latest.log and Lunar Client at %UserProfile%/.lunarclient/logs/client/latest.log) for death events. Bedrock Edition is not supported.Rust
Tracked Events: DeathsTails
output_log.txt next to the Rust executable for the You died markerRuneScape: Dragonwilds
Tracked Events: DeathsTails
%LocalAppData%/RSDragonwilds/Saved/Logs/RSDragonwilds.log for the death-state transitionWar Thunder
Tracked Events: Kills, DeathsPolls War Thunder’s local HUD message endpoint at
http://127.0.0.1:8111/hudmsg to detect events in real time. The local .clog combat log is read only to extract the player’s nickname.Grand Theft Auto
Tracked Events: DeathsUses on-screen OCR to detect the
WASTED notification and bookmark the death.Enabling Game Integrations
From Settings UI
- Navigate to Settings > Games
- Find the Game Integrations section
- Toggle the switch for each game you want to enable
- Integration activates automatically when you launch the game
Game integrations cannot be enabled or disabled while recording is in progress.
Configuration
boolean
default:"true"
Enable automatic event detection for Counter-Strike 2
boolean
default:"true"
Enable automatic event detection for League of Legends
boolean
default:"true"
Enable automatic event detection for PUBG: Battlegrounds
boolean
default:"true"
Enable automatic event detection for Rocket League
boolean
default:"true"
Enable automatic event detection for Dota 2
boolean
default:"true"
Enable automatic event detection for Minecraft
boolean
default:"true"
Enable automatic event detection for Rust
boolean
default:"true"
Enable automatic event detection for RuneScape: Dragonwilds
boolean
default:"true"
Enable automatic event detection for War Thunder
boolean
default:"true"
Enable automatic event detection for Grand Theft Auto
How It Works
When a game integration is enabled:1
Game Detection
Segra detects when you launch a supported game
2
Integration Start
The integration service starts and connects to the game’s data API
3
Event Monitoring
The integration continuously monitors for in-game events
4
Automatic Bookmarking
When an event occurs (kill, death, goal, etc.), Segra creates a bookmark automatically
5
Timeline Updates
Bookmarks appear in the recording timeline with event labels
Game-Specific Setup
Counter-Strike 2
CS2 integration requires a Game State Integration configuration file.Setup Instructions
Setup Instructions
Segra automatically creates the required GSI configuration file when:
- CS2 is detected for the first time
- The integration is enabled in settings
-
Navigate to your CS2 config folder:
-
Create a file named
gamestate_integration_segra.cfgwith: - Restart CS2
- Segra will now receive kill/death events
Segra writes this file automatically the first time CS2 is detected. Only follow the manual steps if the auto-created file is missing.
- Kills: Bookmark created each time you eliminate an opponent
- Deaths: Bookmark created when you die
League of Legends
League integration uses the LoL Live Client Data API (no additional setup required).How It Works
How It Works
- LoL exposes game data on
https://127.0.0.1:2999/liveclientdata - Segra polls this endpoint every 250ms during games
- Events are detected by comparing player stats between polls
- Works for all game modes (Summoner’s Rift, ARAM, etc.)
- Kills: Bookmark when your kill count increases
- Assists: Bookmark when you get an assist
- Deaths: Bookmark when you die
PUBG: Battlegrounds
PUBG integration reads the game’s local replay files. No API key or external setup is required.How It Works
How It Works
- PUBG writes replay data to
%LocalAppData%/TslGame/Saved/Demosafter each match - Segra polls this directory for new replays every 2.5 seconds
- When a new replay appears, Segra parses its event stream to extract kill and death timestamps
- Bookmarks are then added to the matching recording
- Kills: Bookmark when you eliminate a player
- Deaths: Bookmark when you’re eliminated
Bookmarks are added after a match finishes, once PUBG writes the replay file. They will not appear in real time during the match.
Rocket League
Rocket League integration uses on-screen OCR to detect goal and assist notifications.How It Works
How It Works
- Segra periodically captures a small region of the gameplay frame
- OCR scans the captured frame for text such as “+100”, “Goal”, or “Assist”
- Matching keywords create the corresponding bookmarks
- No external plugins or BakkesMod are required
- Goals: Bookmark when you score
- Assists: Bookmark when you assist a goal
Bookmark Display
Game integration bookmarks appear with color-coded badges:- Success Events
- Death Events
Green badges for positive events:
- Kills
- Assists
- Goals
Game Detection Settings
Segra can automatically detect games or use manual whitelist/blacklist configuration.Auto-record Games
boolean
default:"true"
Automatically start recording when a game launches. Toggle it in Settings > Games > Game Detection with the Auto-record Games checkbox.When disabled, Segra never auto-starts a recording from game detection. Two exceptions still record:
- Games you added with recording enabled (explicit per-game entries)
- Manual recordings you start yourself
Whitelist
Games in the whitelist will always be recorded when launched.array
default:"[]"
Array of game objects to always record:
Blacklist
Games in the blacklist will never be recorded.array
default:"[]"
Array of game objects to exclude from recording:
Adding Games to Lists
- Navigate to Settings > Games > Game Detection
- Click Add to Whitelist or Add to Blacklist
- Browse to the game’s executable
- The game will be added to the appropriate list
Auto-Detected Launchers
Segra recognizes games installed under any of these launcher paths and records them by default:
For Xbox App / Microsoft Store titles, Segra also reads the
MicrosoftGame.config file next to the executable to extract the display name from ShellVisuals.DefaultDisplayName, so games appear under their proper title instead of the packaged executable name.
Per-Game Overrides
Each entry in the games list can override a subset of your global settings just for that title. Click a game in Settings > Games > Game Detection to expand its override panel:boolean | null
default:"null"
Overrides the global
enableHdr setting when recording this game. null (default) inherits the global setting.number | null
default:"null"
Multiplier applied on top of your configured device volumes for both the game-capture and desktop-audio sources when recording this game. Accepts
0–2 (0 = muted, 1 = unchanged, 2 = doubled). null (default) inherits the global device volumes.Settings JSON Structure
Troubleshooting
Events not being detected
Events not being detected
Counter-Strike 2:
- Verify the GSI config file exists and is correctly formatted
- Check that Segra is listening on port 1340 (not blocked by firewall)
- Restart CS2 after adding the config file
- Ensure you’re in an active game (not lobby/champion select)
- Check that port 2999 is not blocked
- Verify LoL client is running (integration needs the client)
- Verify the replay folder exists at
%LocalAppData%/TslGame/Saved/Demos - PUBG must have replay recording enabled (it is on by default)
- Bookmarks appear after the match ends, not during live play
- Run the game in a supported aspect ratio so the OCR region aligns with the score banner
- Avoid heavy on-screen overlays that obscure the goal/assist text
- Make sure you are running the integration on the active Rocket League window
Too many bookmarks
Too many bookmarks
If you’re getting too many automatic bookmarks:
- Disable integrations for games you don’t want tracked
- Use the whitelist/blacklist to control which games are recorded
- Manually delete unwanted bookmarks after recording
Integration not starting
Integration not starting
- Ensure the integration is enabled in Settings > Games
- Check that Segra service is running (system tray icon present)
- Verify the game is properly detected (check Segra’s game detection)
- Restart Segra and try launching the game again
Performance Impact
Game integrations are designed to have minimal performance impact:- Counter-Strike 2: Uses event-driven GSI on a local HTTP listener (no polling)
- League of Legends: Polls the local Live Client API every 250ms (negligible CPU usage)
- PUBG: Polls the local replay folder every 2.5 seconds and parses replays after a match (no in-game overhead)
- Rocket League: Periodic OCR over a small screen region (low overhead, only active while the game is running)
Future Games
Segra is actively adding support for more games. Request integration support by:- Opening a GitHub issue
- Joining the Segra Discord community
- Contacting support at segra.tv