libratbag

What is libratbag?

libratbag lets you configure DPI, polling rate, button mapping, and macros for a wide range of gaming mice. It started as a community project in 2015 and has grown to support over 200 devices, with regular updates from the open‑source community.

The tool is aimed at gamers and power users who want fine‑grained control without a proprietary client. It runs in the background, reading device events and applying settings from simple configuration files.

Compared with Windows‑only G Hub, libratbag feels lightweight and scriptable. There is no graphical wizard, but you can edit plain text files or use the companion GUI, ratbagctl-gui, for a more familiar interface.

Best for: Gamers who need custom mouse settings on Linux without relying on vendor software.

Key features of libratbag

• Configurable DPI and polling rate
• Button remapping and macro support
• Per‑profile device settings
• Support for multiple devices simultaneously
• CLI and GUI tools
• Open‑source community maintained
• Cross‑distribution packaging

Tips for Windows users

When moving from Logitech G Hub, export your G Hub profiles to XML and import them into libratbag using the ratbagctl import command. Button assignments and DPI settings translate directly, but macro timing may differ; adjust with the CLI. Use ratbagctl-gui for a visual setup if you prefer a GUI. Keyboard shortcuts for ratbagctl are simple: e.g., ratbagctl list to view devices, ratbagctl set-dpi 800 to change DPI.

Workflow changes: instead of a cloud sync, settings are stored in /etc/ratbag or ~/.config/ratbag. Profiles are applied automatically on boot. Remember to run sudo systemctl enable ratbagd to keep the daemon running.