This guide covers Logitech devices connecting via Unifying, Bolt, Nano, or Bluetooth receivers. It replicates Logi Options+ key reassignment and the Actions Ring using Solaar and Kando respectively.

Part 1: Solaar — Key Reassignment

Installing Solaar

Flatpak

flatpak install flathub io.github.pwr_solaar.solaar

The Flatpak version of Solaar may not detect devices out of the box due to udev permission restrictions. If your device is not detected, follow the udev rules setup from the Solaar documentation, or use Flatseal to grant USB device access.

Fedora

sudo dnf install solaar

Arch

sudo pacman -S solaar

Debian/Ubuntu

sudo apt install solaar

If your device is not detected after install, log out and back in, then replug the receiver.

Pairing & managing your device

• Pair a new device

  Click your receiver in the left panel and select Pair new device, then follow the on-screen prompt. Bluetooth devices appear automatically if system Bluetooth is active.

  

• Adjust device settings

  Select your device in the left panel. The right panel exposes all available settings — DPI, scroll direction, pointer speed, and function-key behaviour — depending on your hardware model.

Remapping buttons with rules

The Rules Editor is Solaar's equivalent of Logi Options+ key redirection. Rules intercept a button press and fire a custom action — a keystroke, shell command, or modifier combination — with optional conditions based on the active application.

• Open the Rules Editor

  

• Create a new rule

  Right-click the Rule node and select Add rule. A new empty rule appears in the tree.

• Add a condition

  Right-click the new rule and select Add condition → Key. Choose the mouse button to intercept — for example, Haptic for the haptic button on the MX Masters 4.

• Add an action

  Right-click the same rule and select Add action → Key press. Enter the key combination to send — for example, Super_L + Shift_L + F1 as a dedicated trigger shortcut (which can be used to trigger the Kando Menu to work as Action Ring).

• Save and test

  Click Save. Press the button — the remapped key event fires immediately with no restart needed.

Follow this link to download an example configuration for the MX Masters 4 and MX Keys S.

The configuration files are ready to use if you have the hardware mentioned above. Otherwise, you may have to do some tweaking in the Solaar app.

Part 2: Kando

Installing Kando

Flatpak

flatpak install flathub menu.kando.Kando

Arch (AUR)

yay -S kando-bin

Debian/Ubuntu

Download the .deb package from the Kando releases page and install it.

sudo dpkg -i kando-*.deb

Kando runs as a background process and must be started at login to be available. Add it to your desktop environment's autostart (on Gnome, you can do this in Tweaks).

You must download the Kando Integration extension in order to use Kando in Gnome.

Creating your first menu

• Add a new menu

  Click Add Menu in the left sidebar. Give it a descriptive name — e.g., 'Productivity' — and confirm.

  

• Add items to the ring

  Click the + button in the ring diagram to add actions. Drag items around the ring to arrange them in positions that feel natural for your hand.

• Save and trigger

  Click Save. Use your assigned trigger shortcut (set in the next section) to open the menu and verify your items appear correctly.

Gesture navigation

Kando supports marking menus — a gesture technique where you draw a direction with your cursor to select an item without stopping to click. Once muscle memory is established for a layout, you can open and trigger an action in a single continuous movement, faster than a keyboard shortcut.

Follow this link to download configuration files to achieve the effect in the above video.

Binding menus to shortcuts

Each menu in Kando has an independent trigger: a global keyboard shortcut, a mouse button combination, or a shortcut scoped to a single application.

• Open trigger settings

  In the Kando editor, click the menu you want to configure and select the Trigger tab on the right panel.

• Set a global shortcut

  Click the shortcut input field and press your desired key combination. A key combo fired by a Solaar rule — such as Super + Shift + F1 — works perfectly as a hardware trigger here.

Contributors

aier9500

Changelog

5/23/26, 11:41 PM

View All Changelog

• 28b48-Update video playback settings for demos in guides. Fix broken video.on 5/23/26
• b5534-Change team name, fixing links.on 5/21/26
• 68e3a-Correcting formatting to follow the newest format. Highlighting instead of bolding.on 5/13/26
• cc0a2-Adding logitech-linux-setup resource folder for dotfiles.on 5/13/26
• efd81-Fixing visual bugon 5/13/26
• 5c8f8-Add note for downloading Kando configuration fileson 5/13/26
• 637b7-Add new assets and update Logitech Linux setup guide with Kando integration detailson 5/1/26
• e2434-First iteration Logitech Guideon 4/30/26
• 8befc-Logitech LInux Guideon 4/30/26
• 5810a-Cleaner way of displaying contributors in articles.on 12/9/25
• 26c5a-Restructuring tags.on 11/10/25