Skip to content
aabdelghaniPublic

About

NotLogi: unofficial mouse & keyboard tools for Linux. For Logitech MX Master 4 and 3S, MX Keys and the PRO X3 SUPERSTRIKE: an action ring around the pointer, MX Master 4 haptics and haptic panel, PRO X3 HITS and DPI, buttons, gestures, thumb wheel, SmartShift, smart backlight, Bluetooth pairing and per-application profiles.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

19 stars

Watchers

0 watching

Forks

NotLogi

Unofficial mouse & keyboard tools for Linux (formerly LogiMX)

New in 0.13.0: PRO X3 SUPERSTRIKE

Release build Tests Latest release License: GPL-3.0-or-later Platforms: Linux, Windows, macOS Devices: MX Master 4 and 3S, MX Keys family, PRO X3 SUPERSTRIKE Action ring Flow

NotLogi

NotLogi sets up MX mice and keyboards on Linux, with Windows and macOS in beta. Choose what every button and key does, open an action ring of your favourite actions around the pointer, and use one mouse and keyboard across several computers with Flow.

Important

New in 0.13.0: the PRO X3 SUPERSTRIKE on Linux

Everything G HUB offers for this mouse, now on Linux, without Wine, a VM or an account (only G HUB's online parts are left out). It works through the LIGHTSPEED receiver or the cable.

  • HITS analog buttons: actuation point, rapid trigger and click haptics for each button, HITS codes that work with G HUB's, and the latency test with the switch travel shown live
  • Sensitivity: G HUB's presets, five DPI slots with DPI shift, X/Y split, lift-off distance, up to 8000 Hz
  • G-Shift layer, macros, and DPI actions on any button
  • Onboard memory: write your settings to the mouse so they go with it to any PC

See all of it below

NotLogi is an independent project. It is not affiliated with, endorsed by, or supported by the manufacturer of these devices.

Action ring The ring on the desktop
Action ring Action ring overlay

Install

Download from the latest release.

  • Ubuntu / Debian: sudo apt install ./logimx_0.15.4_amd64.deb, then open NotLogi from the app grid.
  • Any Linux: make the AppImage executable and run it.
  • Windows 10 and 11 (beta): run the setup. If SmartScreen asks, choose More info, then Run anyway.
  • macOS 12 or newer (beta): open the .dmg and drag NotLogi to Applications (signed and notarized, so it opens like any app), then allow Accessibility and Input Monitoring when asked.

Installing over an older version replaces it: the running NotLogi and its agent are closed and the new ones started, and on macOS an older copy left in Applications goes to the Trash.

Quit Logi Options+, Solaar or logiops while NotLogi runs: they drive the same buttons.

To remove NotLogi: About → Remove NotLogi in the app lists what goes and takes it away (settings stay unless you say so). On Linux, logimx-uninstall [--all] does the same from a terminal (installed by the .deb, and in the repository at packaging/uninstall.sh).

Supported devices

Device State
PRO X3 SUPERSTRIKE Tested on its LIGHTSPEED receiver, new in 0.13.0
MX Master 4 Tested
MX Master 3S Tested
MX Keys S Tested
MX Keys, MX Keys for Mac, MX Keys for Business Working, reported by users
MX Anywhere 3S Included, not yet tested
MX Keys Mini, Mini for Mac, Mini for Business Included, not yet tested
Signature K650, K650 for Business Included, not yet tested

Through a Bolt, Unifying or LIGHTSPEED receiver, or over Bluetooth.

Another Logitech keyboard that NotLogi finds but has no photo of still gets every key it reports, in a list. Give it a photo of your own (see Your keyboard's own photo) and share the file it makes in Discussions, so the keyboard can come with NotLogi for everyone.

Features

PRO X3 SUPERSTRIKE

New in 0.13.0. What G HUB offers for the mouse, without its online parts:

  • Sensitivity: G HUB's presets and your own, five DPI slots with the default and DPI shift slots, X and Y apart, lift-off distance, report rate, HERO sensor calibration and a Sensitivity tool
  • HITS: actuation point, rapid trigger and click haptics for each main button, presets, the HITS code, and the latency test with the button's travel shown live
  • Assignments: G HUB's System actions, a G-Shift layer, and macros
  • Gaming surface mode, the onboard memory (use it, or write your settings into a profile), BHOP, time left from the mouse's power model
  • A sensitivity of its own for each app profile
Sensitivity HITS
PRO X3 sensitivity PRO X3 HITS
Assignments Settings
PRO X3 assignments PRO X3 settings

Flow

One mouse and keyboard for several computers (Linux and macOS; Windows untested). Move the pointer off the edge of the screen and it carries on on the next computer, with the keyboard and the clipboard.

  • Set up in three steps: install NotLogi on both, pair the mouse on another channel, same network
  • Drag the computers' screens to where they sit
  • Switch at the edge, or only while holding Ctrl
Flow Flow settings
Flow Flow settings

Setting up Flow

Action ring

Hold a button, flick toward an action, let go. Up to eight actions around the pointer.

  • Click a slot to pick its action, or drag one onto it
  • Folders: put more actions behind one slot; they open on a second circle around the ring
  • Several ring profiles, and a different ring per application
  • Volume and brightness: hold and drag to set the level
  • Small, medium or large
A folder in the settings The folder on the ring
Ring folder in the settings Ring folder on the desktop

Button actions with the action ring

Volume bar while dragging

MX Master 4

  • Haptic feedback with its strength, felt as the action ring moves
  • The haptic panel as a button of its own (it opens the action ring out of the box)
  • How hard the panel has to be pressed, and the wheel's ratchet force
  • Easy-Switch on a photo of its underside
Buttons and the haptic panel Easy-Switch
MX Master 4 buttons MX Master 4 Easy-Switch

Home

Your devices with their battery level.

Welcome

Mouse buttons

Click a button on the photo and choose what it does: suggestions, shortcuts, commands, apps, media, the action ring or gestures.

Mouse buttons

Application profiles

Give an application its own buttons and keys. The profile follows the window in front.

LibreOffice Writer profile: Back is Undo

Point and scroll

Pointer speed, SmartShift, smooth scrolling and scroll direction. The thumb wheel can scroll, zoom, or change volume, tabs or workspaces.

Point and scroll

Gestures

Hold a button and swipe up, down, left or right to run an action.

Keyboard keys

Click a key on the photo of your keyboard and choose what it does.

Keyboard Key actions
Keys Key actions

Your keyboard's own photo

For a keyboard NotLogi has no photo of: on its Keys page, Choose a photo (one taken from above), then click each key on it as NotLogi names them, the Easy-Switch keys last. Save, and the keyboard is drawn like the ones NotLogi comes with: its keys on the photo, and the Easy-Switch page.

Share saves it as one file (the photo inside) for others with the same keyboard, who take it in with Import a device file. The files are kept in the devices folder of NotLogi's settings (~/.config/LogiMX/devices on Linux).

Placing the keys on a photo

Backlight

On or off, automatic or a fixed level, and how long it stays on.

Backlight

Device settings

F keys as standard keys or media keys, lock keys on or off, and the battery over the last week.

Device settings

Emoji picker

The Emoji key opens a searchable picker at the pointer.

Emoji picker

Overlays, tray and notifications

On-screen notices when you mute the mic or switch computers, battery levels in the tray, and a warning when the battery runs low.

Notifications Tray
Notifications Tray panel

Themes

Light, Dark, Ubuntu and Ubuntu dark.

Dark GNOME
Dark GNOME

Bluetooth

Put a mouse or keyboard in pairing mode and NotLogi offers to connect it.

Pairing pop-up Add device over Bluetooth
Pairing pop-up Add device over Bluetooth

More

  • Pair with a Bolt receiver
  • Back up, restore, export and import your settings
  • Start at login, or hidden in the tray
  • A first-run wizard that sets everything up

First run

Wishes and problems

Make a wish or Report an issue from the home screen. A report fills in what is needed and leaves out personal details; it is filed from your own GitHub account.

Make a wish Report a problem
Make a wish Report a problem

How it works

A small background agent talks to the devices; the app is its settings window.

Architecture

Building from source, the command line and the technical details are in docs/DEVELOPMENT.md.

Related projects

  • Solaar: device manager for Unifying and Bolt receivers
  • logiops: daemon with gestures and SmartShift
  • libratbag and Piper: DPI and buttons for gaming mice

About

NotLogi: unofficial mouse & keyboard tools for Linux. For Logitech MX Master 4 and 3S, MX Keys and the PRO X3 SUPERSTRIKE: an action ring around the pointer, MX Master 4 haptics and haptic panel, PRO X3 HITS and DPI, buttons, gestures, thumb wheel, SmartShift, smart backlight, Bluetooth pairing and per-application profiles.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

19 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages