ther0n/unnaturalscrollwheels

Invert scroll direction for physical scroll wheels while maintaining "Natural" scrolling for trackpads on MacOS

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 15 minutes ago
Added to GitGenius on September 16th, 2026
Created on July 24th, 2020
Open Issues & Pull Requests: 48 (+0)
GitHub issues: Enabled
Number of forks: 95
Total Stargazers: 4,212 (+0)
Total Subscribers: 25 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 7.2 hours
Mean response time: 46.6 days
90th percentile: 46.5 days
Tracked items: 23

Most active contributors

Sign in to see contributor activity.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 15
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 495 days
Stale 30+ days: 13
Stale 90+ days: 9

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 1
Events in 7 days: 1

Top labels

No label distribution available yet.

Detailed Description

Unnaturalscrollwheels is a macOS utility that inverts scroll direction for physical scroll wheels while preserving natural scrolling on trackpads.

The tool solves the problem of conflicting scroll direction preferences between input devices on macOS. Modern macOS defaults to "natural" scrolling, where moving fingers up on a trackpad scrolls content up, matching the intuitive gesture-based interaction model. However, this same setting inverts the behavior of traditional scroll wheels, where users typically expect upward wheel rotation to scroll content up. Unnaturalscrollwheels detects which input device is being used and applies the appropriate scroll direction independently, allowing users to maintain natural scrolling on trackpads while restoring conventional scroll wheel behavior.

This tool is suited for macOS users who regularly switch between trackpad and external mouse input and find the default scroll behavior unsatisfactory for one or both devices. It addresses a specific usability gap that arises from macOS's one-size-fits-all scroll direction setting. Users who prefer natural scrolling on trackpads but find inverted scroll wheels frustrating will benefit from this approach, as will those who want to customize scroll behavior without resorting to system-wide settings changes that affect all input methods uniformly.

The project shows active maintenance with regular commits addressing user-reported issues and feature requests. Development includes responsiveness to bug reports with timely fixes and incorporation of user feedback into updates. The codebase demonstrates attention to edge cases and compatibility concerns specific to different macOS versions and hardware configurations. The maintainer engages with the community through issue discussions and implements improvements based on real-world usage patterns reported by users.