g13-linux 1.2.2

Logitech G13 Linux driver with macro support, RGB control, and LCD display management

G13 Linux

Python userspace driver for the Logitech G13 Gaming Keyboard on Linux.

Features

• 22 Programmable G-Keys with macro support
• RGB Backlight Control with full color range
• 160x43 LCD Display with custom text and graphics
• Thumbstick Support with configurable zones
• Profile Management for different applications
• PyQt6 GUI for visual configuration

Installation

# From PyPI
pip install g13-linux

# Or with pipx (recommended for CLI tools)
pipx install g13-linux

System Dependencies

# Ubuntu/Debian
sudo apt install libhidapi-hidraw0

# Fedora
sudo dnf install hidapi

udev Rules (Required)

# Allow non-root access to G13
sudo cp udev/99-logitech-g13.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger

Usage

CLI

g13-linux --help              # Show help
g13-linux --version           # Show version
g13-linux                     # Run the input daemon
g13-linux run                 # Run the input daemon (explicit)

# LCD control
g13-linux lcd "Hello World"   # Display text on LCD
g13-linux lcd --clear         # Clear the LCD

# Backlight control
g13-linux color red           # Set backlight to red
g13-linux color "#FF6600"     # Set backlight to hex color
g13-linux color 255,128,0     # Set backlight to RGB

# Profile management
g13-linux profile list        # List available profiles
g13-linux profile show eve    # Show profile details
g13-linux profile load eve    # Load and apply a profile
g13-linux profile create new  # Create a new profile
g13-linux profile delete old  # Delete a profile

GUI

g13-linux-gui         # Launch the configuration GUI

Python API

from g13_linux import open_g13, G13Mapper

# Open device and start mapping
device = open_g13()
mapper = G13Mapper()

# Read events
while True:
    data = read_event(device)
    if data:
        mapper.handle_raw_report(data)

Hardware

Component	Status
G1-G22 Keys	✅ Working
M1-M3 Mode Keys	✅ Working
MR Key	✅ Working
Thumbstick	✅ Working
LCD Display	✅ Working
RGB Backlight	✅ Working

Note: Button input requires either:

• udev rules for hidraw access, or
• sudo with libusb mode (g13-linux-gui --libusb)

Linux kernel 6.19+ will include native hid-lg-g15 support for G13.

Development

# Clone and setup
git clone https://github.com/AreteDriver/G13_Linux.git
cd G13_Linux
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/ tests/

License

MIT License - see LICENSE for details.

Links

• PyPI Package
• GitHub Issues
• Logitech G13 Specs