Skip to content

Repository files navigation

RemoMouse

RemoMouse turns a first-generation Siri Remote into a precise pointer and system controller for macOS Tahoe. It is native, local-only, and open source.

Status

RemoMouse 0.1.0 is a public beta. It runs in the menu bar and supports touch pointer movement, click and drag, secondary click, continuous precision scrolling with momentum, pointer/scroll modes, speed control, Mission Control, and pause/resume.

This beta intentionally ships the dependable core before customization. Per-app profiles, editable button mappings, launch at login, onboarding, a settings window, notarization, and Air Pointer are deferred and are not advertised as complete.

Download

Download the latest app and checksum from GitHub Releases. See the installation guide for pairing, Accessibility permission, and Gatekeeper instructions.

Requirements

  • macOS Tahoe 26.0 or newer
  • A first-generation black Siri Remote paired in System Settings → Bluetooth

Building from source additionally requires Xcode 26.6 or newer.

Default controls

Remote input Action
Touch Move pointer; swipe the right edge or use two fingers for trackpad-style scrolling
Touch click Primary click and drag
Menu Secondary click
Play/Pause Toggle Pointer and Scroll modes
Volume Adjust pointer speed
Home/TV Mission Control
Siri Pause/resume

Build and test

swift test --parallel
Scripts/package-app.sh release
open .build/RemoMouse.app

On first launch, open the menu-bar popover and choose Allow Accessibility…, then enable RemoMouse in System Settings → Privacy & Security → Accessibility. RemoMouse never prompts automatically on later launches. Press a remote button to wake it after it has been idle.

Compatibility note

Buttons use public IOKit HID APIs. On current macOS, first-generation touch data is exposed through Apple's private MultitouchSupport framework. That compatibility bridge is dynamically loaded, strictly filtered to the Siri Remote, and documented in Architecture. This prevents initial Mac App Store distribution and may require updates after macOS changes.

Air Pointer is not enabled in 0.1.0 because the validated Mac did not deliver usable motion reports from this remote. The evidence and release gate are documented in the motion capability report; the working touch and button paths are unaffected.

Privacy

RemoMouse is local-only. Hardware captures stay under the user's Application Support directory, and committed reports must redact device identifiers, Bluetooth addresses, usernames, and home-directory paths.

Roadmap

  • Optional gyroscope-based Air Pointer mode with deliberate activation and recentering
  • Per-app profiles and customizable mappings
  • Developer ID signing, notarization, and automatic updates

Contributing and security

Contributions are welcome under CONTRIBUTING.md. Report vulnerabilities privately according to SECURITY.md. RemoMouse is licensed under the MIT License.

Project documentation

RemoMouse is an independent project and is not affiliated with or endorsed by Apple Inc. Apple TV and Siri Remote are trademarks of Apple Inc.

About

Use a first-generation Siri Remote as a precise macOS pointer and controller.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages