/grayscale

macOS status bar app for easily toggling the grayscale display filter

Primary LanguageSwiftMIT LicenseMIT

grayscale

grayscale is a macOS status bar app for managing the system grayscale display filter. It allows you to toggle grayscale mode easily by clicking the status bar icon or using a keyboard shortcut, and it also supports enabling or disabling grayscale based on which application is currently active.

Using the grayscale filter can help you reduce your screen time. For more information, check out the following links:

grayscale has been tested on macOS 11 Big Sur but may also work on other versions.

Using grayscale

grayscale enables or disables grayscale mode based on the active application. It stores a default grayscale value, which determines whether grayscale mode should be on or off for all applications that have not overridden it. To toggle the default value, you can left click the status bar icon or use a keyboard shortcut. Right-clicking the icon brings up a menu, which allows you to view the default value, override it for the active application, and configure the keyboard shortcut.

grayscale is designed to make using grayscale mode practical. It's not realistic to keep your screen in grayscale all the time, and automatic transitions reduce the burden of manually turning it on and off. I recommend enabling grayscale by default and disabling it for specific applications that benefit from colors but don't use them to capture your attention, like a text editor with syntax highlighting. Potentially addictive applications that sometimes need color, like web browsers, can then be used with the default setting (i.e. with grayscale enabled), and you can use the keyboard shortcut to toggle grayscale as necessary.

Installing grayscale

Install option 1: homebrew

Run brew install --cask --no-quarantine brettferdosi/tap/grayscale. grayscale.app will be installed in /Applications.

Install option 2: run the installer (easiest for non-technical users)

Download the most recent installer (GrayscaleInstaller.pkg) from the releases page. To run the installer, control-click its icon, click Open, then click Open again. See the Apple support page if the process for running apps from unidentified developers has changed. It will install grayscale.app in /Applications. If there is already a version of grayscale.app on your system, the installer will detect and overwrite it.

Install option 3: build from source

Clone this git repository using git clone --recurse-submodules and run make in it. grayscale.app will be placed into build/Build/Products/Release.

Optional: open at login

Automatically open grayscale at login by adding it to the list in System Settings > General > Login Items. See the Apple support page if the location of the list has changed.