A Qt6/QML control center for Linux peripherals.
Mice, keyboards and audio. One interface, existing Linux backends.
Русский · Download v0.5.1 · Device support · Report an issue
Qt6/QML is now the only application interface. Logi Center has moved from
GTK to a graphite-and-amber dashboard, interactive device editors and shared
Python services. python app.py and the installed application launcher open QML.
The previous GTK implementation remains in Git history; cutover and recovery
documents the archived baseline.
Logi Center is not Logitech-only. It brings existing Linux device services and a small set of model-specific adapters into one place. Controls follow the actual capabilities of the device, firmware and backend. It does not claim universal support for a brand or recreate Windows-only features without a working Linux implementation.
These are English screenshots of the real QML application, captured on Hyprland/Wayland workspace 9 with live read-only device data. No hardware settings were changed for the images. Full gallery and capture details. Warnings and unavailable values are genuine device/backend states.
- Mice: edit supported DPI stages, polling rates, onboard profiles, button assignments and lighting. G502 has shared top/side SVGs and all 11 native button IDs.
- Keyboards: select keys and edit supported layouts, RGB and per-key settings. Ace68-II functions are gated to the implemented firmware protocol; G515 uses Solaar.
- RGB: prefer native firmware effects, with zones, period and brightness where the provider exposes them. No silent host-side animation loop.
- Macros: record keys, clicks and delays in a separate capture window and keep a private reusable library. Device upload remains capability-specific.
- Audio: choose outputs/inputs, set defaults, adjust volume/mute and use explicit microphone tests or EasyEffects presets. Recording starts only on request.
- Data: edit drafts before Apply, preview/select backup fields, restore with a private safety snapshot and export redacted diagnostics.
- Preferences: English/Russian, reduced motion, custom device names/artwork and QML scaling from 75–200% after restart.
Hardware work runs outside the GUI thread. Commands are serialized and guarded against disconnection, stale state and profile changes. Sent, cached, verified, unverified and failed results remain distinct. Shared services and existing backup formats are retained.
| Device / backend | Available integration | Verification boundary |
|---|---|---|
| Logitech G502 HERO / libratbag | DPI, polling, profiles, buttons/macros, two reported lighting zones | User verified LED 1 Color Cycle at 8000 ms / brightness 255 continues after closing the app. Other effects/zones are not all physically verified. RGB report |
| MCHOSE K7 Ultra | DPI/buttons/sensor panels, charging indicators and native dock RGB | Selected reversible tests and dock observations are recorded individually. A receiver may be present while the sleeping mouse does not answer; the app does not invent values. Controls, dock |
| MCHOSE Ace68-II, firmware 121 | Key selection, actuation/RT/dead zones, native effects, key maps and supported advanced banks | Earlier selected writes/readbacks were physically tested; many newer bank/per-key paths are mock-tested only. No unverified firmware/calibration operations. Editor |
| Logitech G515 LS TKL / Solaar | Scoped settings, native RGB, brightness/timers and available per-key data | Live settings take precedence; RGB control Off does not make the device unavailable. No complete G HUB parity claim. G515 |
| EWEADN S9 family | Model-verified DPI, polling/performance/sensor controls, button editor and supplied SVG | Protocol/source and mock validation; no physical S9 confirmation here. Native macro-bank upload is disabled pending safe read/rollback. S9 |
| Other providers | OpenRGB, OpenRazer, rivalcfg, HeadsetControl, PipeWire/PulseAudio and Linux input | Runtime capability-driven subsets; ckb-next is discovery-only. Exact model support follows each provider. Backend matrix |
Implemented, mock-tested and physically verified are different states. Unknown devices retain generic Linux input and honest unavailable controls. See the action-level matrix for remaining limits.
Download the source archive or Arch package from v0.5.1.
Check SHA256SUMS before using the release assets. This is a Python/Qt application,
not a self-contained AppImage; the runtime dependencies must be installed.
Arch Linux runtime:
sudo pacman -S --needed python python-yaml python-gobject pyside6 qt6-declarative qt6-svg qt6-waylandRun the extracted source folder:
python app.py
# Isolated demo — no real hardware operations:
python app.py --simulateOr clone a lightweight current checkout and install for your user:
git clone --depth 1 https://github.com/Mirox921/logi-center.git
cd logi-center
python install.py
logi-centerThe installer updates ~/.local/share/logi-center, ~/.local/bin/logi-center
and the application-menu entry. After pulling source updates, rerun the
installer to update the menu-launched copy. User preferences, drafts and
backups are preserved. No root is needed for this installer.
Vendor backends are optional and installed separately: for example, libratbag for compatible mice, Solaar for supported Logitech devices and HeadsetControl for headset features. Do not run the entire GUI as root to bypass HID access. Launch guide · Local Arch build.
Source code uses src/logi_center, shared assets live in assets, and tests are
split into unit, integration and mocked hardware contracts. See the
repository architecture and package workflow.
python scripts/check.py # unit tests and compilation
python scripts/gui_smoke.py # QML loading, navigation and qmllint
python scripts/simulation_smoke.py # real service paths, mock hardware I/ODeveloper artwork tools also need PyCairo. CI additionally covers model editors, backups, localization, SVG rendering and reconnect/readback guards. Automated checks do not replace physical device validation.
The repository keeps application code, assets and licenses, tests/fixtures, protocol evidence and a small release gallery. Generated captures, local agent files, caches and built packages stay out of Git. Historical review screenshots are archived locally, and prior published releases remain in Git history. Screenshot policy.
Logi Center application code is licensed under GNU GPL v3.0 only
(GPL-3.0-only); see LICENSE and COPYRIGHT.
Qt, fonts, separately licensed artwork and backend projects retain
applicable notices and licenses. See bundled SOURCES.md and license files.
When reporting a device issue, include its model, firmware/backend version and
a redacted diagnostic report. Do not publish serials, private macros, raw HID
buffers or user configuration files.




