Native GTK4 Remap Studios β’ Chroma RGB Lighting β’ Mouse DPI & Polling β’ In-Game HUDs β’ Powered by input-remapper & OpenRazer
Strop is a Linux control suite for Razer devices: remap keys, tune mouse DPI and polling, build macros, edit RGB lighting, and manage HUD overlays for gameplay. Explore the Strop Website for interactive hardware compatibility filters and studio galleries.
- Supported target: Ubuntu 26.04 LTS, GNOME on Wayland, Python 3.14, and GTK4 (input-remapper 2.2.0).
- Hardware scope: primarily Razer keyboards, keypads, mice, and related Linux input devices covered by the current support matrix.
- Recommended first step: install the latest release, then read the user guide and support matrix.
Download the latest verified package and release artifacts from the Strop releases page.
# Example: install the current Debian package
sudo apt install ./strop_1.2.1_all.debFor setup steps and troubleshooting, see docs/USER_GUIDE.md and docs/SUPPORT.md.
If you are testing Strop for the first time, use this flow:
- Check the support matrix to confirm your platform and device are covered.
- Install the current release from GitHub Releases.
- Launch the Hub with
./strop.pyor the installed desktop entry. - Read the user guide before changing mappings, macros, or lighting profiles.
- Report issues through the issue tracker.
Strop was created with substantial assistance from generative AI, including AI-generated code and documentation. AI assistance is part of the project's development process and may also be used for documentation, automation, and project management tasks.
AI-generated work can contain bugs, incorrect assumptions, and inaccurate descriptions of hardware or software behavior. The use of AI does not establish that the code has received an independent review or formal validation.
The maintainer remains responsible for what is accepted and released. Please evaluate Strop against your own needs, back up your remapping profiles before making changes, and report problems through the issue tracker.
The primary source for Strop is dedmo399/strop on GitHub. The main branch is the canonical development branch.
Clone the repository over HTTPS:
git clone https://github.com/dedmo399/strop.git
cd stropFor an existing checkout, get the latest committed source with git pull --ff-only on main. To propose a change, follow CONTRIBUTING.md. Generated .deb and .tar.gz release artifacts can be rebuilt with build_deb.sh.
The only official 1.2 support target is Ubuntu 26.04 LTS, GNOME on Wayland, Python 3.14, and GTK4, with input-remapper 2.2.0. The hardware scope remains the Razer Tartarus Pro, BlackWidow, Huntsman, Naga, Basilisk, and comparable supported inputs listed in the support matrix.
Strop's catalog contains 230+ device entries and generic layout archetypes. Catalog presence is reference data; it does not mean a device has been tested or is officially supported. Other distributions, desktop environments, or device families may work but are not in scope for support commitments.
Strop uses Python 3, PyGObject, GTK 4, and python-evdev. Hardware remapping requires input-remapper; OpenRazer is used for lighting and device control.
- Macro Studio & Composer: Built-in gaming combos such as Bullet Jump and Ability Combos, plus productivity shortcuts with custom millisecond delays.
- Unified RGB Lighting & Chroma Effects Studio: 60 FPS internal render loop, 16 lighting presets, interactive Cairo HSV color wheel + SV square, multi-stop gradient editor, and 2D vector zone mapping.
- Mouse DPI & Polling Rate Controller: OpenRazer hardware sensor capability discovery, X/Y DPI and stage table editors, polling rate selection, and per-device persistence.
- Polychromatic dark slate & emerald theme design language.
Use the Hub to discover devices, open studios, apply saved profiles, and manage the tray applet and HUD overlays.
Open dedicated studios for hardware-specific layouts and device controls:
- Keypad remapping and layouts
- Keyboard remapping and layout presets
- Mouse DPI, polling, and button assignment
- Macro composition and assignment
- RGB lighting profiles and effect editing
- In-game HUD overlays
# Unified Hub Dashboard & 230+ Device Catalog
./strop.py
# Dedicated Macro Studio
./strop_macro.py
# Unified RGB Lighting & Chroma Effects Studio
./strop_lighting.py
# Generic Keypad Studio (Tartarus / Orbweaver / Nostromo)
./strop_keypad.py
# Generic Keyboard Studio (BlackWidow / Huntsman / DeathStalker / Blade)
./strop_keyboard.py
# Generic Mouse Studio (Naga MMO / Basilisk FPS / Viper Ambi)
./strop_mouse.py
# In-Game HUD Overlay
./strop_hud.py
# Universal Studio CLI
./strop_studio.py --device="<Device Name>"The official 1.2 target is Ubuntu 26.04 LTS, GNOME on Wayland, Python 3.14, and GTK4. Other distributions are not in the support matrix.
Download strop_1.2.1_all.deb, strop_1.2.1.tar.gz, and SHA256SUMS from the Strop 1.2.1 release into the same directory. Verify both downloads before installation:
sha256sum --check SHA256SUMSBoth files should report OK. Checksums detect corrupted or changed downloads; they are not an independent signature of the release. If verification fails, download the files again before proceeding.
Install the verified Debian package with apt:
sudo apt install ./strop_1.2.1_all.debTo build fresh .deb and .tar.gz release artifacts at any time:
./build_deb.shSource checkout launchers use the ./strop*.py commands above. To add an installed package to the application menu, install the .deb; it provides a system desktop entry and icons.
See docs/USER_GUIDE.md for first-run and profile steps. docs/SUPPORT.md lists the platform matrix, device scope, package requirements, permission guidance, and troubleshooting notes.
The active Strop roadmap details completed milestones and the 2.0 plan for Tartarus Pro key-depth access, controller outputs, and hardware settings built on input-remapper and OpenRazer.
Strop builds upon the foundational work of the Linux input and hardware community:
- input-remapper by Sezanzeb and contributors β Provides the underlying Linux
evdev/uinputremapping service and the stable device-mapping workflow Strop uses. - OpenRazer (openrazer/openrazer) by the OpenRazer contributors β Provides the open-source Linux kernel drivers and daemon used for lighting and sensor control.
- GTK 4, PyGObject, Cairo, and python-evdev β The core toolkit, bindings, rendering, and input layers that power the Linux desktop experience.
Strop is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Razer Inc.
For setup and troubleshooting, read the user guide and support matrix. Report ordinary bugs through the issue tracker. To contribute code or documentation, see CONTRIBUTING.md.
- Version:
1.2.1 - License: GNU General Public License v3.0 or later (
GPL-3.0-or-later); full license text: LICENSE.
Maintained by Strop Contributors. Source and issue tracking: dedmo399/strop.
