VaZark/achroma

GNOME Display Grayscale Extension

★ 0Forks 0GitHub ↗Compare

Project website ↗

README

Achroma

A GNOME Shell extension that toggles your display to monochrome/grayscale mode with a single click.

Useful for reducing eye strain, improving focus, or accessibility.

Features

  • One-click toggle for monochrome display
  • Multiple color profiles to choose from
  • Settings persist between sessions
  • Lightweight and simple

Profiles

Profile Description
Grayscale Standard full desaturation
Soft Subtle 70% desaturation
High Contrast Grayscale with enhanced contrast
Low Brightness Darker grayscale for night use
Sepia Warm vintage tone

Installation

From GNOME Extensions Website

  1. Visit Achroma on extensions.gnome.org
  2. Click the toggle to install

Manual Installation

  1. Clone or download this repository:

    git clone https://github.com/ktauchathuranga/achroma.git
  2. Copy to GNOME extensions directory:

    cp -r achroma ~/.local/share/gnome-shell/extensions/[email protected]
  3. Compile the schema:

    glib-compile-schemas ~/.local/share/gnome-shell/extensions/[email protected]/schemas/
  4. Restart GNOME Shell:

    • On Wayland: Log out and log back in
    • On X11: Press Alt+F2, type r, press Enter
  5. Enable the extension:

    gnome-extensions enable [email protected]

Usage

Action Result
Left click on icon Toggle effect on/off
Extension Preferences Select color profile

Opening Preferences

Via command line:

gnome-extensions prefs [email protected]

Or via Extension Manager app: Click the gear icon next to Achroma.

Requirements

  • GNOME Shell 50 or later

Reloading the extension

gnome-extensions disable [email protected] && gnome-extensions enable [email protected]

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue.

Contributors

ktauchathurangalevu42

Issues