# LinearMouse

Free Mac mouse and trackpad utility for scrolling, pointer acceleration/speed, button actions and per-device or app profiles.

> This is the Markdown version of the LinearMouse page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/linearmouse>

- **Latest version**: `0.13.0`
- **Developer**: lujjjh and contributors
- **Homepage**: <https://linearmouse.org/>
- **Categories**: [Utilities](https://opennavo.com/categories/utilities)
- **Install**: `brew install --cask linearmouse`
- **30-day installs**: 5,714
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://dl.linearmouse.org/v0.13.0/LinearMouse.dmg>
- **SHA-256**: `609276d5db79874034c9469a4eb56ccde6ed6fd01c52404f41fd4b493042789b`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "login_item": "LinearMouse",
          "quit": "com.lujjjh.LinearMouse"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "LinearMouse.app"
      ],
      "target": "/Applications/LinearMouse.app"
    },
    "phase": "install",
    "sources": [
      "LinearMouse.app"
    ],
    "target": "/Applications/LinearMouse.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.config/linearmouse",
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.lujjjh.linearmouse.sfl*",
            "~/Library/Preferences/com.lujjjh.LinearMouse.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

LinearMouse is a free, open-source macOS utility for tuning mouse and trackpad behavior. It is aimed at people who want separate controls for different devices, applications and displays rather than one system-wide pointer setting.

### Features
- Set scrolling direction independently for a mouse and trackpad.
- Adjust scrolling behavior, pointer speed and pointer acceleration, including disabling acceleration.
- Use device/app/display profiles for different workflows.
- Map buttons and scrolling actions to shortcuts, media controls and system actions.
- Configure long presses, button combinations and swipe gestures in0.12.0.
- Use supported Logitech hardware features such as DPI and wheel controls; support varies by model and connection type.

### Installation and use
Install with `brew install --cask linearmouse`, or download the official DMG and move LinearMouse to Applications. Open it and follow the requested macOS Accessibility permissions so it can modify input events. Select the device and adjust a small number of settings before configuring profiles. Login-item behavior and an optional menu-bar item are available. Other pointer or keyboard tools may also alter the same events; this is not a guarantee that every combination of utilities or device driver is compatible.

### Requirements and platforms
LinearMouse targets macOS and has Intel and Apple Silicon platform entries in the current Homebrew cask. The official0.12.0 application Info.plist specifies macOS10.15 or later; the download was built with the macOS26.5 SDK. Future builds made with the macOS27 SDK may require12.0, according to the version-tagged source configuration, so check the release you install. The cask lists no additional formula dependencies and conflicts with `linearmouse@beta`. Minimum RAM and installed storage were not established in the cited guide. No official Windows, Linux, iOS or Android application edition was established.

The official0.12.0 DMG is5,001,442bytes, distinct from installed footprint. Supported hardware-dependent features are not available on every mouse, and Logitech USB-receiver and Bluetooth behavior can differ. This is a mouse/trackpad customization utility, not a replacement for macOS or a universal vendor firmware updater.

### Accounts, price and license
LinearMouse is MIT-licensed and free to use, with optional sponsorship. Local configuration does not require a LinearMouse subscription or cloud account. The project is maintained by lujjjh and contributors. Refer to the official privacy policy for online update and other data handling, and to the repository license for third-party notices.

Sources: [Official website](https://linearmouse.app), [Repository](https://github.com/linearmouse/linearmouse), [Releases](https://github.com/linearmouse/linearmouse/releases).

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 0.13.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/l/linearmouse.rb> · Checked 2026-11-21
  - <https://dl.linearmouse.org/v0.13.0/LinearMouse.dmg>
  - SHA-256: `609276d5db79874034c9469a4eb56ccde6ed6fd01c52404f41fd4b493042789b`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 0.13.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/l/linearmouse.rb> · Checked 2026-11-21
  - <https://dl.linearmouse.org/v0.13.0/LinearMouse.dmg>
  - SHA-256: `609276d5db79874034c9469a4eb56ccde6ed6fd01c52404f41fd4b493042789b`

## LinearMouse security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/linearmouse/linearmouse> · Open source: Yes — <https://github.com/linearmouse/linearmouse> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask linearmouse`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Login items: `LinearMouse` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/l/linearmouse.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask linearmouse`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.config/linearmouse` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/l/linearmouse.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/com.lujjjh.linearmouse.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/l/linearmouse.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.lujjjh.LinearMouse.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/l/linearmouse.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

## Latest release notes

### 0.13.0 (2026-11-15)

#### What's Changed
##### New features
* Add a hold trigger for converting pointer movement to scroll by @anandghegde in https://github.com/linearmouse/linearmouse/pull/1400
* Lock the pointer during button mapping swipes by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1415
* Add focus follows mouse without raising windows by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1419
* Make swipe distance and pointer locking configurable by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1449
* Auto Scroll indicator is smaller and matches the macOS look by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1481
* Auto Scroll keeps scrolling the window it started in after the cursor leaves it by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1482
* Auto Scroll speeds up more the farther the pointer moves, like Firefox by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1483
* Auto Scroll can scroll in the reverse direction by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1485
* Settings follow a Logitech mouse whether it uses a receiver or Bluetooth by @lujjjh and @reowens in https://github.com/linearmouse/linearmouse/pull/1488
##### Bug fixes
* Fix swipe recording after a provisional long press by @lujjjh and @lamhoangtung in https://github.com/linearmouse/linearmouse/pull/1413
* Fix receiver discovery with offline paired devices by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1421
* Fix hover focus crash when opening settings by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1425
* Fix high-resolution scroll direction in button mappings by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1429
* Reduce repeated actions from high-resolution scrolling by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1433
* Prevent accidental scroll recording with high-resolution wheels by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1444
* Fix cursor jumping back after dragging a button used in mappings by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1447
* Apply held keyboard modifiers to mouse and scroll events by @GtechGovind in https://github.com/linearmouse/linearmouse/pull/1438
* Restore mappings for buttons recovered from HID reports by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1448
* Fix mistranslated settings and button mapping guidance by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1450
* Fix hover focus never leaving VS Code by @EduRomoGO in https://github.com/linearmouse/linearmouse/pull/1472
* Don't set serial number for mouse button keybindings when All Mice is selected by @oliver-leung in https://github.com/linearmouse/linearmouse/pull/1456
* Scrolling to change volume or brightness responds per wheel notch again by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1479
* Auto Scroll triggered by a Logitech button starts at the cursor by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1480
* Show the paired device's name after it reconnects to a receiver by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1486
* Show the battery level of devices behind a receiver in the device picker by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1487
* Receiver settings for parent or group apps keep applying after a mouse behind it gets its own settings by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1489
* Middle-clicking a Safari Favorites bar icon opens the bookmark instead of starting Auto Scroll by @lujjjh and @kzaoaai in https://github.com/linearmouse/linearmouse/pull/1498
* Memory no longer grows each time the keyboard input source changes by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1505
* Unifying receivers no longer retry discovery forever while a paired device is offline by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1506
##### Other changes
* Reduce CPU overhead from pointer motion events by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1412
* Throttle scroll-triggered actions by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1414
* Migrate legacy gesture buttons to button mappings by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1416
* Avoid redundant settings updates with scheme diffs by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1422
* Group pointer settings and scope tracking reset by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1424
* Use the new permission name on macOS 27+ and improve permission setup by @lujjjh in https://github.com/linearmouse/linearmouse/pull/1442

#### New Contributors
* @lamhoangtung made their first contribution in https://github.com/linearmouse/linearmouse/pull/1413
* @GtechGovind made their first contribution in https://github.com/linearmouse/linearmouse/pull/1438
* @EduRomoGO made their first contribution in https://github.com/linearmouse/linearmouse/pull/1472
* @oliver-leung made their first contribution in https://github.com/linearmouse/linearmouse/pull/1456
* @reowens made their first contribution in https://github.com/linearmouse/linearmouse/pull/1488
* @kzaoaai made their first contribution in https://github.com/linearmouse/linearmouse/pull/1498

**Full Changelog**: https://github.com/linearmouse/linearmouse/compare/v0.12.0...v0.13.0

## Facts and sources

- <https://opennavo.com/apps/linearmouse>
- <https://opennavo.com/apps/linearmouse/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/l/linearmouse.rb> · Checked 2026-11-21
- <https://formulae.brew.sh/cask/linearmouse>
- <https://github.com/linearmouse/linearmouse> · Checked 2026-11-13
