Skip to content

jlevere/hidpp

Repository files navigation

HID++

Configure Logitech devices without Logitech Options+. Open source, runs on macOS, Linux, and Windows.

Supports 170+ Logitech devices over Bluetooth LE and USB receivers (Bolt, Unifying, Lightspeed).

MX Master 3S configuration

Install

Homebrew (macOS)

brew install jlevere/tap/hidpp
brew services start hidpp

Grant Input Monitoring and Accessibility in System Settings → Privacy & Security.

From source (Linux / Windows / macOS)

cargo install --git https://github.com/jlevere/hidpp --locked \
  --bins -p hidpp-cli -p hidpp-daemon

Tracks main. To pin a release, add --tag vX.Y.Z.

Linux users: install udev/99-hidpp.rules for non-root HID access. Build deps: libudev-dev, libxkbcommon-dev, libglib2.0-dev, libgtk-3-dev, libxdo-dev.

Config

Edit ~/.config/hidpp/config.toml (created on first launch):

[buttons]
83 = "alt+left"       # Back → browser back
86 = "alt+right"      # Forward → browser forward

[gestures.195]        # Gesture button (thumb)
up = "ctrl+up"        # Swipe up → Mission Control
down = "ctrl+down"    # Swipe down → App Exposé
left = "ctrl+left"    # Swipe left → prev desktop
right = "ctrl+right"  # Swipe right → next desktop
tap = "playpause"     # Quick tap → play/pause

Web

Configure DPI, scroll mode, button remaps, and Easy-Switch hosts from the browser. No install required.

https://jlevere.github.io/hidpp/

Works in Chrome and Edge (WebHID). Demo mode works in any browser.

CLI

hidpp info
hidpp get battery
hidpp set dpi 1600
hidpp export

Development

cargo build --workspace --exclude hidpp-web  # native
nix build .#dmg                              # local macOS DMG

License

MIT or Apache-2.0.

About

Configure Logitech devices without Options+

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

 
 
 

Contributors