Skip to content

ifeign/Linux-Arctis-Manager

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

194 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Linux Arctis Manager

An open-source replacement for SteelSeries GG, to manage your Arctis headset on Linux!

GitHub Release AUR Version Python Build Discord Fluxer

🎚️ Key Points

  • Control ChatMix - enable and control balance between Media and Chat audio streams
  • Configure any device via a simple configuration file
  • Enable per-device features by adding them in the relative configuration file
  • D-Bus based communication, to support different clients (alternative clients, Plasma extensions, etc)

🎧 Supported Devices

Device ChatMix Advanced Features Product ID(s)
Arctis 1 / Xbox ❌ ❌ 12b3, 12b6
Arctis 1 Wireless ❌ ❌ ❓
Arctis 3 Console Edition ❌ ❌ ❓
Arctis 7 / 7 2019 / Pro 2019 / Pro GameDAC ❌ ❌ 1260, 12ad, 1252, 1280
Arctis 9 ❌ ❌ 12c2
Arctis Pro Wireless ❌ ❌ 1290
Arctis Nova 3 ❌ ❌ 12ec
Arctis Nova 3P Wireless / 3X Wireless ❌ ❌ 2269, 226d
Arctis Nova 5 βž– βœ… 2232, 2253
Arctis Nova 7 / 7X / Diablo IV / Gen 2 (% battery) βœ… βœ… 22a1, 227e, 2258, 229e, 22a9, 22a5
Arctis Nova 7 / 7X / Diablo IV / Gen 2 (discrete battery) βœ… βœ… 2202, 2206, 223a, 227a, 22a4
Arctis Nova 7+ / PS5 / Xbox / Destiny ❌ ❌ 220e, 2212, 2216, 2236
Arctis Nova 7P ❌ ❌ 220a
Arctis Nova Elite ❌ ❌ ❓
Arctis Nova Pro Wireless / X βœ… βœ… 12e0, 12e5
Arctis Nova Pro ❌ ❌ ❓

Legend

Symbol Description
βœ… Supported: supported and fully implemented
❌ Not Implemented: support not yet available
βž– N/A: not physically supported by this headset model
❓ Missing Data: product ID is not yet known. Help us find it!

⌨️ CLI Commands

  • lam-daemon: the background service that communicates with your headset, managed by systemd
  • lam-cli: command-line utilities for setup tasks like installing udev rules and desktop entries
  • lam-gui: the graphical interface to configure your headset and view its status

Tip

Not sure what a command does? Run it with -h or --help to see all available options.

πŸ“¦ Install & Setup

Choose the installation method that fits your setup:


Distrobox

Run the following script to install:

curl -LsSf https://raw.githubusercontent.com/elegos/Linux-Arctis-Manager/refs/heads/develop/scripts/distrobox.sh | sh

Note

For Immutable Distros (Bazzite, Fedora Silverblue, etc.), the app behaves like a native installation rather than an isolated container. Because Distrobox mounts your /home, /var, and /etc directly, the manager can interact with the system services and configuration files it needs to function.


Arch Linux (AUR)

Arch Linux users can install the community-maintained package from the Arch User Repository (AUR):

  1. Install with your preferred AUR helper:

    yay -S linux-arctis-manager
    
    # using paru: paru -S linux-arctis-manager
  2. Continue to Final Setup

For packaging-specific issues, report directly to the AUR maintainers: @tonitch and @Aiyahhh.


Manual Install

Note

pip can be used instead of pipx, but pipx is recommended for better dependency isolation. Some distros will require pipx.

Prerequisites

Install pipx with your package manager.

Option A: Install from Release (recommended)

  1. Download the latest .whl from the releases page

  2. From the directory you downloaded it to, install it:

    pipx install linux_arctis_manager-*.whl
    
    # using pip: pip install --user linux_arctis_manager-*.whl
  3. Continue to Final Setup

Option B: Install from Source

  1. Install uv (installation guide) and create the applications directory:

    mkdir -p $HOME/.local/share/applications
  2. Get the source:

    git clone https://github.com/elegos/Linux-Arctis-Manager.git
    cd Linux-Arctis-Manager
    git pull
  3. Build:

    rm -rf dist
    uv build
  4. Install:

    find ./dist -name "*.whl" | head -n1 | xargs pipx install --force
    
    # using pip: find ./dist -name "*.whl" | head -n1 | xargs pip install --user --force-reinstall

Final Setup

# required on first install, or after updating for new device support
sudo lam-cli udev write-rules --force --reload

# produces desktop entries β€” optional after first install
lam-cli desktop write

Note

Skip this if you installed via Distrobox - the setup script handles this automatically.

Tip

To launch the system tray icon automatically on login, copy its desktop entry to your autostart folder:

cp ~/.local/share/applications/lam-gui-tray.desktop ~/.config/autostart/

🧹 Uninstall / Cleanup

  1. Stop and disable the service:

    systemctl --user disable --now arctis-manager
    rm ~/.config/systemd/user/arctis-manager.service
  2. Remove leftover files:

    # desktop menu entries
    lam-cli desktop remove
    
    # udev rules
    sudo rm -f /etc/udev/rules.d/91-steelseries-arctis.rules
    sudo rm -f /usr/lib/udev/rules.d/91-steelseries-arctis.rules
    
    # user preferences and device/lang files
    rm -rf ~/.config/arctis_manager
  3. Uninstall the package:

    pipx uninstall linux_arctis_manager
    
    # using pip: pip uninstall linux_arctis_manager

πŸ› οΈ Development

Basic Commands

  • Run the daemon: uv run lam-daemon
  • Run the CLI: uv run lam-cli
  • Run the GUI: uv run lam-gui [--no-enforce-systemd] (use this option to avoid force enabling the daemon, in case you're working on it)

Documentation

⚠️ Troubleshooting

  • App or headset becomes unresponsive: systemctl --user restart --now arctis-manager
  • Newly supported device does not appear after an update: lam-cli udev write-rules --force --reload
  • App fails to start with a Qt xcb platform error: install libxcb-cursor0 (Debian/Ubuntu) or xcb-util-cursor (Arch/Fedora). Required on non-Qt desktop environments like Cinnamon.

πŸ’¬ Community & Support

Linux Arctis Manager is a community-driven project - the more hardware data and feedback we get, the better support becomes for everyone.

Join us on:

Missing a Device?

If your headset isn't listed in the support table, we likely just need your hardware IDs to get started. See our Hardware Support Guide for instructions on how to find and submit your Product ID (PID).


Linux Arctis Manager is licensed under the GPL-3.0 and is not affiliated with or endorsed by SteelSeries ApS. SteelSeries, Arctis, ChatMix, and SteelSeries GG are trademarks of their respective owners.

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 97.8%
  • Shell 2.1%
  • CSS 0.1%