Skip to content

EricxWood/Scroil

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Scroil

Scroil is a smooth-scrolling extension for Windows that makes mouse wheel scrolling feel more natural, consistent, and customizable.

Features

  • Global Smooth Scrolling: Brings smoother mouse wheel scrolling across your apps on Windows, reducing the jumpy feeling of apps's default scrolling behavior.
Scroil OFF (Windows Default) Scroil ON (Smooth)
Scroil.OFF.webm
Scroil.ON.webm

  • Optimized for High-Refresh-Rate Displays: Scroil is built for extremely high-refresh-rate screens, with a backend polling rate of 1000 Hz, similar to a gaming mouse. High-refresh-rate displays are not just for games anymore; Scroil helps make everyday web browsing and app scrolling feel smoother too. Actual visible smoothness may still be limited by the app's own GUI framework or rendering engine, especially if that app cannot render at the display's full refresh rate.

  • Custom Scroll Feel: Adjust speed, step size, acceleration, deacceleration, and fine-grained scroll behavior.

    Custom Scroll Feel


  • Scrolling Accelerator: Increases scroll speed during faster wheel movement, making long pages easier to move through.
Scroil OFF (Windows Default) Scroil ON (Scroll hundreds of lines in a second with the same natural wheel motion)
Scroil.OFF.webm
Scroil.ON.webm

  • App Picker & Per-App Control: Add currently open programs to your Scroil profile list, customize scrolling experience for each app.

    App Profiles


  • Auto App Classifier: Automatically recognizes Chromium-based apps, including Teams, Discord, Outlook and others, then applies the right scrolling config for that app type.

    Auto App Classifier


  • Game Detection: Recognizes games automatically and turn off smooth scroll for games to avoid interfering with your gameplay.

    Game Detection

Supported Apps

Scroil includes built-in support for common Windows apps.

App
VS Code VS Code icon
WeChat WeChat icon
Chrome Chrome icon
Files Files icon
Microsoft Word Microsoft Word icon
Microsoft Excel Microsoft Excel icon
Firefox Firefox icon
Apple Music Apple Music icon
Microsoft Edge Microsoft Edge icon

Scroil also supports almost all mainstream Electron, WebView, and Chromium-based apps through automatic app classification. Examples include Microsoft Teams Microsoft Teams icon, Discord Discord icon, Outlook Outlook icon, Notion Notion icon, Tidal Tidal icon, Spotify Spotify icon, and other browser-based desktop apps.

Current Restrictions

Some apps are currently unsupported, including File Explorer and many older desktop apps. These apps often use older or system-level scrolling behavior that does not provide reliable pixel-wise scrolling precision, so Scroil cannot smooth them safely yet.

Electron, WebView, and Chromium-based apps are supported, but the experience may not be perfect in every app. Many of these apps already apply their own internal smooth scrolling, so Scroil has to work around that built-in behavior.

OS and Hardware Requirements

Scroil has been verified working on Windows 10 and Windows 11. It may need a reasonably responsive system for the best smooth-scrolling experience, and the effect is more noticeable on high-refresh-rate displays.

Important Note for VS Code, Chrome, Edge, and Firefox Users

To get the best result with Scroil, turn off built-in smooth scrolling in apps that already apply their own smooth-scroll effect. Otherwise, their own scrolling behavior can conflict with Scroil.

Chrome

  1. Open Chrome.
  2. In the address bar, enter:
chrome://flags/#smooth-scrolling
  1. Set Smooth Scrolling to Disabled.
  2. Relaunch Chrome.

Edge

  1. Open Edge.
  2. In the address bar, enter:
edge://flags/#smooth-scrolling
  1. Set Smooth Scrolling to Disabled.
  2. Relaunch Edge.

Firefox

  1. Open Firefox.
  2. Open Settings.
  3. Go to General > Browsing.
  4. Turn off Use smooth scrolling.
  5. If you cannot find it, enter about:config in the address bar, search for general.smoothScroll, and set it to false.

VS Code

  1. Open VS Code.
  2. Open Settings.
  3. Search for smooth scrolling.
  4. Turn off Editor: Smooth Scrolling.
  5. If needed, also turn off smooth scrolling in any extensions or custom settings that re-enable it.

About

Windows system-wide smooth scroll plugin. Be happy to scroll on oil! Project is still under development

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages