🌐 Website & download → quangtruong2003.github.io/SmoothScroll
Smooth mouse-wheel scrolling for Windows 10 and Windows 11. Native low-level input interception, frame-perfect easing, per-app exclusion. A free, open-source alternative to Logitech SmoothScroll, WizMouse, and Mac-style inertia scrolling utilities — built with Rust, Tauri 2, and React.
macOS support is coming soon. Track progress in issues.
Jerky native scroll → SmoothScroll eased scroll
Most mice and trackpads emit discrete wheel ticks that feel jagged on apps without native inertia. SmoothScroll sits between the OS and your applications, swallows raw wheel events, and re-emits them as fluid, eased pulses at 120 Hz — giving you Mac-style smooth scrolling on Windows. Configurable easing, per-application opt-out, system-tray UI, global hotkey toggle. Free, open-source, no telemetry.
- Native input interception — low-level mouse hook on Windows (
WH_MOUSE_LL). Works in any app that accepts wheel input. - Frame-perfect easing — pluggable curves (Linear, Cubic, Quintic, Exponential), tuned for 120 Hz output.
- Per-app exclusion — opt specific applications out by process name; everything else stays smoothed.
- Global hotkey — toggle smoothing on/off without leaving your keyboard. Default
Ctrl+Alt+S. - System tray — left-click for settings, right-click for quick controls.
- Themed UI — light/dark/system, multi-language (i18next), keyboard-accessible.
- Auto-update — built-in updater, signed releases, opt-in.
- Tiny footprint — single Rust binary, no Electron, no background services.
Grab SmoothScroll_<version>_x64-setup.exe (NSIS) or .msi from the Releases page and run it. Installation is per-user — no administrator privileges required.
Requirements: Windows 10/11 with WebView2 runtime (preinstalled on Windows 11).
macOS support is in development. Track progress in issues.
SmoothScroll supports both X11 and Wayland sessions on Linux.
X11: Uses libxinput2 for wheel event interception.
Wayland: Uses /dev/uinput (requires membership in the input group) and libevdev for scroll event capture. Flatpak is not supported.
Requirements:
- libwebkit2gtk-4.1-0
- libayatana-appindicator3-1 (for system tray)
- libx11-6, libxi6, libxtst6 (X11 only)
Setup for Wayland:
sudo gpasswd -a $USER input
sudo bash -c 'echo "KERNEL==\"uinput\", GROUP=\"input\", MODE=\"0660\", OPTIONS+=\"static_node=uinput\"" > /etc/udev/rules.d/99-smoothscroll.rules'
sudo udevadm control --reload-rules
# Log out and back in, then restart SmoothScrollKnown limitations: Wayland scroll passthrough behavior varies by compositor. GNOME tray may need AppIndicator extension.
| Action | How |
|---|---|
| Open settings | Left-click tray icon |
| Quick menu | Right-click tray icon — Enable, Open Settings, Exit |
| Toggle on/off | Ctrl+Alt+S (rebindable in settings) |
| Exclude an app | Settings → Excluded Apps → add by process name |
Settings file: %APPDATA%\SmoothScroll\settings.json
Logs (rotated daily, retained 7 days): %APPDATA%\SmoothScroll\logs\
SmoothScroll is structured as a workspace with a clean separation between pure logic, OS-specific I/O, and UI.
┌────────────────────────────────────────────────────────────────┐
│ src/ (React + TypeScript) │
│ Settings UI · Radix primitives · Tailwind · Zustand · i18next │
└──────────────────────────────┬─────────────────────────────────┘
│ Tauri IPC
┌──────────────────────────────▼─────────────────────────────────┐
│ src-tauri/ (Tauri 2 · Rust) │
│ Composition root · IPC commands · tray · global hotkey │
└──────────────────────────────┬─────────────────────────────────┘
│
┌──────────────────┴──────────────────┐
▼ ▼
┌───────────────────────┐ ┌─────────────────────────────┐
│ crates/core/ │ │ crates/platform/ │
│ Engine · easing math │ │ Windows: low-level hook │
│ Settings model │ │ macOS: CGEventTap │
│ No OS dependencies │ │ Process resolver · emitter │
│ Fully unit-tested │ │ Behind trait abstractions │
└───────────────────────┘ └─────────────────────────────┘
| Path | Purpose |
|---|---|
crates/core/ |
Scroll engine, easing math, settings model. Pure Rust, OS-agnostic, fully unit-tested. |
crates/platform/ |
OS-specific implementations behind traits — Windows hook, macOS event tap, wheel emitters, process queries. |
src-tauri/ |
Tauri 2 host — composition root, IPC commands, tray, hotkey wiring, lifecycle. |
src/ |
React + TypeScript settings UI. |
docs/ |
Specs, design notes, migration plans. |
Prerequisites
- Rust 1.95+ (pinned via
rust-toolchain.toml) - Node.js 20+ with pnpm
- Windows: MSVC build tools, WebView2 runtime (preinstalled on Windows 11)
Build
git clone https://github.com/quangtruong2003/SmoothScroll
cd SmoothScroll
npm install
npm run tauri dev # run with hot reload
npm run tauri build # produce installersOutput: src-tauri/target/release/bundle/{nsis,msi}/
Test
cargo test --workspaceLatest release — feature-complete v1 on Windows. macOS support is in development.
| SmoothScroll | LibreScroll | Windows built-in | |
|---|---|---|---|
| System-wide | ✅ | ✅ | ❌ |
| Per-app profiles | ✅ | ❌ | ❌ |
| Game mode | ✅ | ❌ | ❌ |
| Open source | FSL-1.1 | GPL-3.0 | Proprietary |
Install SmoothScroll from the Releases page, launch it, and scrolling becomes smooth system-wide. No drivers, no admin rights, no reboot required. Toggle on/off any time with Ctrl+Alt+S.
SmoothScroll re-emits raw mouse-wheel ticks as eased pulses at 120 Hz, producing the same gliding inertia feel as macOS trackpad scrolling — for any wheel mouse, in any Windows app that accepts wheel input.
Yes. SmoothScroll is free for personal, educational, research, and internal use under the Functional Source License (FSL-1.1-Apache-2.0). No telemetry, no ads. Commercial use that competes with SmoothScroll requires a separate license — contact the author. Two years after each release, the code automatically converts to Apache 2.0.
Yes. SmoothScroll intercepts wheel events at the OS level via the Windows low-level mouse hook (WH_MOUSE_LL), so it works with any mouse the OS recognizes — including Logitech MX Master, Razer, Logitech G-series, and trackpads.
- vs. WizMouse / KatMouse — those tools redirect scroll to the window under the cursor; SmoothScroll adds the eased motion curve on top.
- vs. Logitech SetPoint / Options+ — works with any mouse, not just Logitech hardware.
- vs. Windows built-in — Windows has no system-wide smoothing; only some apps (Edge, Chrome) implement their own.
SmoothScroll uses standard Windows SetWindowsHookEx API — the same API used by accessibility tools, screen readers, and remote-desktop software. It does not inject into any process. Per-app exclusion lets you disable it for games or apps that prefer raw input.
Settings: %APPDATA%\SmoothScroll\settings.json
Logs (rotated daily, retained 7 days): %APPDATA%\SmoothScroll\logs\
Yes! SmoothScroll supports both X11 and Wayland on Linux. For Wayland, you'll need to add yourself to the input group and set up udev rules for /dev/uinput access. See the Linux section above for setup instructions.
Issues and pull requests are welcome. For substantial changes, open an issue first to discuss the approach. Run cargo fmt, cargo clippy -- -D warnings, and cargo test --workspace before submitting.
If this helps your workflow, star us on GitHub — it helps others find the project.
Licensed under the Functional Source License, Version 1.1, Apache 2.0 Future License (FSL-1.1-Apache-2.0).
What you can do for free:
- View, study, and learn from the source code
- Use it for personal, educational, or research purposes
- Use it internally within your organization
- Modify it and contribute back via pull requests
- Redistribute copies under the same license
What requires a separate commercial license:
- Offering SmoothScroll (or a substantially similar product) as a paid product or service
- Selling, sublicensing, or hosting it as a competing commercial offering
Future Apache 2.0 grant: Two years after each release date, that release automatically becomes available under the Apache License 2.0 — fully open source, no restrictions.
For commercial licensing inquiries, please open an issue or contact the author.
Copyright © 2026 Quang Truong (@quangtruong2003)