How valospectra/spectra-client works
Spectra Client is an Electron desktop app for a Valorant observer and optional auxiliary observer. The main workflow is to collect live game events through Overwolf’s GEP, format or package them, and send them to the Spectra Server; the Angular UI supplies connection details and tournament overlay configuration. The client also supports hotkey-triggered match events, persisted settings, and external preview/session features. Some UI and Electron wiring is only partially excerpted, so those relationships are shown as unverified rather than asserted as direct calls.
Main entry points: observer.component.ts Observer setup · main.ts Electron runtime · connectorService.ts Server connection · gepService.ts GEP event capture
Components 24
Desktop runtime
- Electron runtime
src/main.ts - IPC bridge
src/preload.ts - Angular shell
angular/src/app/app.component.ts
Game data and transport
- GEP event capture
src/services/gepService.ts - Data formatting
src/services/formattingService.ts - Server connection
src/services/connectorService.ts - Global hotkeys
src/services/hotkeyService.ts
Observer configuration
- Observer setup
angular/src/app/observer/observer.component.ts - Auxiliary setup
angular/src/app/AuxiliaryComponent/auxiliary.component.ts - App settings
angular/src/app/options/options.component.ts - Local settings store
angular/src/app/services/localstorage.service.ts - Input validation
angular/src/app/services/validation.service.ts
Tournament tools
- Match details
angular/src/app/teaminfo/teaminfo.component.ts - Series and map
angular/src/app/seriesinfo/seriesinfo.component.ts - Tournament details
angular/src/app/tournamentinfo/tournamentinfo.component.ts - Player cameras
angular/src/app/playercams/playercams.component.ts - Branding overlays
angular/src/app/sponsor/sponsor.component.ts - Round display
angular/src/app/roundwinbox/roundwinbox.component.ts
Other components
- Observer operator
- Spectra Server
- Map-ban service
- Preview service
- Overwolf game events
- Session API
Connections 23
- Observer operator → Observer setup: configures
- Observer setup → Electron runtime: submits settings
- Electron runtime → GEP event capture: initializes capture
src/main.ts - GEP event capture → Overwolf game events: reads game events
- GEP event capture → Server connection: sends event data
src/services/gepService.ts - Electron runtime → Server connection: coordinates connection
src/main.ts - Server connection → Spectra Server: streams match data
- Global hotkeys → Server connection: sends match events
src/services/hotkeyService.ts - Electron runtime → Global hotkeys: activates hotkeys
src/main.ts - Angular shell → IPC bridge: uses IPC bridge
- Observer setup → Local settings store: reads settings
angular/src/app/observer/observer.component.ts - App settings → Local settings store: persists settings
angular/src/app/options/options.component.ts - Observer setup → Input validation: validates inputs
angular/src/app/observer/observer.component.ts - Observer setup → Match details: configures teams
angular/src/app/observer/observer.component.ts - Observer setup → Series and map: configures series
angular/src/app/observer/observer.component.ts - Observer setup → Tournament details: configures event
angular/src/app/observer/observer.component.ts - Observer setup → Player cameras: configures cameras
angular/src/app/observer/observer.component.ts - Observer setup → Branding overlays: configures branding
angular/src/app/observer/observer.component.ts - Observer setup → Round display: configures display
angular/src/app/observer/observer.component.ts - Auxiliary setup → Electron runtime: submits auxiliary settings
- Observer setup → Map-ban service: creates map-ban session
angular/src/app/observer/observer.component.ts - Observer setup → Preview service: requests preview
angular/src/app/observer/observer.component.ts - Map-ban service → Session API: creates session