Settings Overview

Segra provides comprehensive settings to customize your recording experience. Settings are organized into sections accessible from the Settings page.

Settings Location

Settings are stored in a JSON file at:

%AppData%\Segra\settings.json

Manually editing the settings file is not recommended. Use the Settings UI to ensure proper validation and formatting.

Settings Sections

Account

Manage your Segra account authentication and profile.

JWT and refresh token storage
Account linking and authentication

Recording

Configure how Segra captures your gameplay.

Capture Mode

Choose between Session, Buffer, or Hybrid recording modes

Video Settings

Resolution, framerate, encoder, and codec configuration

Audio Devices

Select input and output audio sources

Hotkeys

Configure keyboard shortcuts for bookmarks and replay buffer

Storage

Manage where recordings are saved and storage limits. See Storage Settings for detailed information.

Games

Configure game detection and automatic event tracking.

Auto-record Games (autoRecordGames): Automatically start recording when a game launches. Defaults to true. When disabled, Segra does not auto-start recordings. Games you’ve added with recording enabled still record, and manual recording still works.

See Game Integration for supported games.

Preferences

Customize the Segra interface and behavior:

Run on Startup: Launch Segra when Windows starts
Close Button Action (closeButtonAction): Segmented control that controls what happens when you press the window’s close (X) button. Minimize hides Segra to the system tray so recording continues; Exit quits the app. Defaults to Minimize.
Confirm Before Deleting (confirmBeforeDeleting): When enabled, Segra shows a confirmation dialog before deleting a video, clip, highlight, custom-game executable, or recoverable file. Defaults to false (delete without confirmation).
Sound Effects Volume: Adjust notification sound levels (0.0-1.0)
Show New Badge on Videos: Highlight recently recorded content
Show Game Background: Display game artwork in UI
Show Audio Waveform in Timeline: Visualize audio in the editor

Segra also remembers the main window’s position and size between launches (lastWindowState, backend-managed). The persisted object includes x, y, width, height, and maximized. On the next launch Segra restores the last non-maximized bounds and re-maximizes the window if it was maximized at close. It re-opens on the monitor it was last closed on, and falls back to centering on the primary monitor if that monitor is no longer connected. To recover a lost or off-screen window, right-click the tray icon and choose Reset window size, which repositions the window and resets it to 1280×720 (DPI-scaled on Windows).

Advanced

Access advanced configuration options:

OBS Version Selection (selectedOBSVersion): Choose specific OBS version or use automatic (latest non-beta)
Update Channel (receiveBetaUpdates): Dropdown — Stable or Beta. When set to Beta, Segra opts into pre-release builds
Display Capture Method: Select between Auto, DXGI, or WGC
Force Mono Input Sources: Convert stereo mic input to mono
Input Noise Suppression (inputNoiseSuppression): Apply noise suppression to microphone input
Separate Audio Tracks: Record audio sources to separate tracks (up to 6 tracks)
Audio Output Mode: Control which applications are recorded
- All: Record all system audio
- GameOnly: Record only game audio
- GameAndDiscord: Record game audio plus a shared voice-chat track (Discord, Discord Canary, Discord PTB, TeamSpeak, TeamSpeak 3)

AI & Highlights

Enable Highlights (enableAi): Enable automatic highlight generation features
Auto-Generate Highlights (autoGenerateHighlights): Automatically create highlight reels from sessions that contain highlight-worthy bookmarks
Highlight Padding Before (highlightPaddingBefore): Seconds of context kept before each highlight bookmark (default 4, range 1–60)
Highlight Padding After (highlightPaddingAfter): Seconds of context kept after each highlight bookmark (default 4, range 1–60)

Menu Items (menuItems): Toggle visibility for sidebar entries. Known IDs: Full Sessions, Replay Buffer, Clips, Highlights, Settings (the Settings entry is always visible).
Default Menu Item (defaultMenuItem): The screen Segra opens on launch. Defaults to Full Sessions.

Capture Mode

Segra offers three recording modes:

Session
Buffer
Hybrid

Records continuously from game start to game end. Best for:

Full match recordings
Review and analysis
Creating montages from entire sessions

Files are saved automatically when the game closes.

Replay Buffer Settings

When using Buffer or Hybrid mode, configure:

integer

default:"30"

Duration in seconds to keep in memory (5-600 seconds, set via the Buffer Duration input)

integer

default:"1000"

Maximum buffer size in MB

Buffer settings cannot be changed while recording. Stop the current recording to adjust these values.

Audio Devices

Segra supports multiple audio inputs and outputs simultaneously.

Selecting Devices

Input Devices (Microphones): Click the dropdown and select one or more microphone sources
Output Devices (Desktop Audio): Select which audio outputs to capture
Volume Control: Adjust individual device volumes (0.0-1.0)

Default Device

The “Default Device” option dynamically tracks your system’s default audio device. If you change your default microphone or speakers in Windows, Segra will automatically use the new default.

Advanced Audio Options

boolean

default:"false"

Force stereo microphone inputs to mono. Useful for USB mics that report as stereo but only use one channel.

boolean

default:"false"

Record each audio source to a separate track (up to 6 total). Enables per-source volume control during editing.

string[]

Parallel to audioTrackNames. Each entry classifies the track as "mix", "input" (microphone), or "output" (system/game audio). Segra uses this list to render the microphone, headphones, or waveform icon next to each track in the video editor’s segment cards. Managed automatically alongside audioTrackNames; recordings without this field still work.

enum

default:"All"

Control which applications are recorded:

All: All system audio
GameOnly: Only the detected game
GameAndDiscord: Game + voice chat (Discord, Discord Canary, Discord PTB, TeamSpeak, TeamSpeak 3; filters other apps)

Display Selection

For multi-monitor setups:

object

default:"null"

Choose which monitor to record:

Automatic: Records the monitor where the game appears
Specific display: Always record from selected monitor

enum

default:"Auto"

Screen capture technology:

Auto: Let Segra choose the best method
DXGI: Desktop Duplication API (faster, older tech)
WGC: Windows Graphics Capture (better compatibility)

boolean

default:"true"

Capture HDR metadata when the source display is in HDR mode. When disabled, Segra forces SDR capture even on HDR displays.

Session Management

boolean

default:"false"

Automatically delete session recordings that have no bookmarks. Useful for automatically cleaning up uneventful gameplay.

Hidden Settings

Some settings have no UI toggle and are only editable by hand in settings.json.

number[]

default:"[20, 50, 100, 500]"

Target sizes (in MB) offered by the video page’s Copy button dropdown (“Copy as compressed file”). Segra sorts entries ascending and only shows entries smaller than the source file. Set to [] to hide the compressed-copy menu. The 20 MB default matches Discord’s current non-Nitro upload limit; users still on the previous [10, 50, 100, 500] default are migrated on upgrade, while customized lists are left alone.

Settings JSON Structure

Key settings properties:

{
  "contentFolder": "C:/Users/YourName/Videos/Segra",
  "cacheFolder": "C:/Users/YourName/AppData/Roaming/Segra",
  "resolution": "1440p",
  "frameRate": 60,
  "encoder": "gpu",
  "codec": { "friendlyName": "NVIDIA NVENC H.264", ... },
  "recordingMode": "Hybrid",
  "replayBufferDuration": 30,
  "storageLimit": 100,
  "inputDevices": [
    { "id": "default", "name": "Default Device", "volume": 1.0 }
  ],
  "outputDevices": [
    { "id": "default", "name": "Default Device", "volume": 1.0 }
  ],
  "keybindings": [
    { "action": "CreateBookmark", "enabled": true, "keys": [119] },
    { "action": "ToggleRecording", "enabled": true, "keys": [120] },
    { "action": "SaveReplayBuffer", "enabled": true, "keys": [121] },
    { "action": "TogglePreview", "enabled": true, "keys": [122] }
  ]
}

Best Practices

Performance Optimization

Use GPU encoder when available for better performance
Select resolution at or below your monitor’s native resolution
For older systems, use 720p/30fps or Standard preset
Close unnecessary applications before recording

Quality vs File Size

VBR provides better quality-to-size ratio than CBR
CRF/CQP offers best quality for archival recordings
Lower CRF/CQ values = higher quality and larger files
Standard preset balances quality and performance for most users

Audio Configuration

Test audio levels before important recording sessions
Use separate audio tracks if you plan to edit recordings
Enable “GameOnly” mode to avoid capturing music/browser audio
Adjust individual device volumes to balance game and voice

Get Started

Core Features

Configuration

Advanced

Settings Overview

Settings Location

Settings Sections

Account

Recording

Capture Mode

Video Settings

Audio Devices

Hotkeys

Storage

Games

Preferences

Advanced

AI & Highlights

Menu & Navigation

Capture Mode

Replay Buffer Settings

Audio Devices

Selecting Devices

Default Device

Advanced Audio Options

Display Selection

Session Management

Hidden Settings

Settings JSON Structure

Best Practices

​Settings Location

​Settings Sections

​Account

​Recording

Capture Mode

Video Settings

Audio Devices

Hotkeys

​Storage

​Games

​Preferences

​Advanced

​AI & Highlights

​Menu & Navigation

​Capture Mode

​Replay Buffer Settings

​Audio Devices

​Selecting Devices

​Default Device

​Advanced Audio Options

​Display Selection

​Session Management

​Hidden Settings

​Settings JSON Structure

​Best Practices

Settings Location

Settings Sections

Account

Recording

Storage

Games

Preferences

Advanced

AI & Highlights

Menu & Navigation

Capture Mode

Replay Buffer Settings

Audio Devices

Selecting Devices

Default Device

Advanced Audio Options

Display Selection

Session Management

Hidden Settings

Settings JSON Structure

Best Practices