How loteran/arctis-sound-manager works
Arctis Sound Manager is a Linux desktop companion for SteelSeries Arctis headsets, combining headset controls with audio routing, mixing, and processing. The principal workflow is a user changing settings in the GUI, the application applying them through its audio and device-control layers, and audio being routed or processed by PipeWire/PulseAudio. The README also documents clips, profiles, themes, and Stream Guard as product capabilities. Some branches are represented at their owning module or directory because their implementation was not sampled; edges are limited to documented or indexed relationships.
Main entry points: core.py Core engine · sonar_to_pipewire.py Sonar processing · pactl.py Channel mixer · sonar_page.py Sonar EQ interface
Components 22
Application
- D-Bus service
src/arctis_sound_manager/dbus_service.py - Core engine
src/arctis_sound_manager/core.py - Device configuration
src/arctis_sound_manager/config.py - Settings
src/arctis_sound_manager/settings.py
Audio features
- Channel mixer
src/arctis_sound_manager/pactl.py - Media routing
src/arctis_sound_manager/scripts/video_router.py - Sonar processing
src/arctis_sound_manager/sonar_to_pipewire.py - Audio reconfiguration
src/arctis_sound_manager/audio_reconfig.py - Audio profiles
src/arctis_sound_manager/profile_manager.py - Clip capture and library
src/arctis_sound_manager/clip_capture.py - Stream Guard
src/arctis_sound_manager/stream_guard.py
Headset features
- Device state
src/arctis_sound_manager/device_state.py - Headset OLED
src/arctis_sound_manager/oled_manager.py
Interface and sharing
- Desktop GUI
src/arctis_sound_manager/gui - Sonar EQ interface
src/arctis_sound_manager/gui/sonar_page.py - Theme management
src/arctis_sound_manager/gui/theme.py - Bug reporting
src/arctis_sound_manager/bug_reporter.py
Linux audio platform
- PipeWire utilities
src/arctis_sound_manager/pw_utils.py - PulseAudio
- PipeWire services
Other components
- Headset user
- Arctis headset
Connections 24
- Headset user → Desktop GUI: controls
- Desktop GUI → Sonar EQ interface: opens EQ
src/arctis_sound_manager/gui/home_page.py - Sonar EQ interface → Sonar processing: configures EQ
src/arctis_sound_manager/gui/sonar_page.py - Sonar EQ interface → D-Bus service: sends commands
src/arctis_sound_manager/gui/sonar_page.py - Sonar processing → PipeWire services: generates configs
src/arctis_sound_manager/sonar_to_pipewire.py - Sonar processing → Settings: reads settings
src/arctis_sound_manager/sonar_to_pipewire.py - Sonar processing → Audio reconfiguration: requests restart
src/arctis_sound_manager/sonar_to_pipewire.py - D-Bus service → Core engine: dispatches requests
src/arctis_sound_manager/dbus_service.py - Core engine → Device state: reads state
src/arctis_sound_manager/core.py - Core engine → Device configuration: uses device config
src/arctis_sound_manager/core.py - Core engine → Channel mixer: controls channels
src/arctis_sound_manager/core.py - Core engine → Sonar processing: manages processing
src/arctis_sound_manager/core.py - Core engine → Headset OLED: manages display
src/arctis_sound_manager/core.py - Channel mixer → PulseAudio: controls sinks
src/arctis_sound_manager/pactl.py - Channel mixer → PipeWire utilities: uses utilities
src/arctis_sound_manager/pactl.py - Media routing → PipeWire utilities: detects native streams
src/arctis_sound_manager/scripts/video_router.py - Media routing → Audio reconfiguration: coordinates changes
src/arctis_sound_manager/scripts/video_router.py - Audio profiles → Settings: stores configuration
- Headset user → Clip capture and library: saves captures
- Headset user → Stream Guard: uses protection
- Headset OLED → Arctis headset: updates display
src/arctis_sound_manager/oled_manager.py - Headset user → Theme management: customizes appearance
- Headset user → Audio profiles: saves audio setup
- Headset user → Bug reporting: reports problems