explaingit

caldis/mos

Analysis updated 2026-06-21

20,096SwiftAudience · generalComplexity · 1/5LicenseSetup · easy

TLDR

A free macOS menu bar app that makes external mouse scrolling feel smooth like a trackpad and lets you remap mouse buttons to system shortcuts or scripts.

Mindmap

mindmap
  root((Mos))
    Scrolling
      Smooth interpolation
      Per-app settings
      Direction reversal
    Button remapping
      System shortcuts
      Script execution
      Mission Control
    Compatibility
      Logitech Bolt
      Bluetooth mice
      macOS 10.13 plus
    Install
      Homebrew cask
      GitHub Releases
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Make your external mouse scroll wheel feel as smooth as a MacBook trackpad on macOS.

USE CASE 2

Reverse vertical scroll direction on your mouse independently from the trackpad without affecting other devices.

USE CASE 3

Remap mouse buttons to trigger Mission Control, switch Spaces, take screenshots, or run custom scripts.

USE CASE 4

Configure different scroll speed and direction settings per application, such as Figma versus a code editor.

What is it built with?

SwiftmacOS

How does it compare?

caldis/mossnapkit/snapkitreactivecocoa/reactivecocoa
Stars20,09620,33519,846
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity1/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

May require granting macOS Accessibility permissions after installation.

CC BY-NC 4.0, free to use and share for non-commercial purposes, commercial use is not permitted.

In plain English

Mos is a small macOS utility that makes external mouse scrolling feel smooth and natural, similar to how a trackpad feels on a MacBook. When you use a regular mouse wheel on macOS, the scrolling tends to feel choppy or abrupt compared to the fluid inertia scrolling on Apple's own trackpads. Mos intercepts the scroll wheel events from your mouse and applies interpolation, turning them into smoother, animated movements. Beyond smooth scrolling, Mos also lets you independently reverse the scroll direction for horizontal and vertical axes, so you can have natural trackpad-style scrolling vertically while keeping a different direction horizontally, for example. You can configure these settings differently per application, so a design tool might have different scrolling behavior than a browser or code editor. The app also supports mouse button remapping: you can bind mouse buttons or keyboard shortcuts to system actions like Mission Control, Space switching, screenshots, accessibility actions, running scripts, or opening files and applications. It has a dedicated "Scroll Function Key" option for temporarily switching behaviors (like turbo scrolling or direction flip) while holding a button. Logitech mice using Bolt/Unifying receivers or Bluetooth are specifically supported with additional HID protocol integration. Mos is a free, open-source menu bar application (it sits in the Mac menu bar, not as a regular window) written in Swift. It supports macOS 10.13 and later. Install it via GitHub Releases or Homebrew (brew install --cask mos). The license is CC BY-NC 4.0.

Copy-paste prompts

Prompt 1
I installed Mos on my Mac. Help me set it up so my Logitech mouse scrolls smoothly and the side buttons trigger Mission Control and Space switching.
Prompt 2
How do I configure Mos to have different scroll speed and direction settings for Figma compared to VS Code?
Prompt 3
Set up Mos so that holding a mouse button temporarily activates turbo scrolling mode while the button is held.
Prompt 4
My Logitech mouse uses a Bolt receiver, what extra steps do I need in Mos to enable the HID integration for the best experience?

Frequently asked questions

What is mos?

A free macOS menu bar app that makes external mouse scrolling feel smooth like a trackpad and lets you remap mouse buttons to system shortcuts or scripts.

What language is mos written in?

Mainly Swift. The stack also includes Swift, macOS.

What license does mos use?

CC BY-NC 4.0, free to use and share for non-commercial purposes, commercial use is not permitted.

How hard is mos to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mos for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub caldis on gitmyhub

Verify against the repo before relying on details.