gnome-shell-extension-caffeine

March 5, 2026 ยท View on GitHub

License GitHub release (latest by date)

Enable / disable auto suspend with quick setting toggle.

Quick Toggle Caffeine

Version

This extension supports GNOME Shell 3.4 -> 50

BranchVersionCompatible GNOME version
master59GNOME 45 -> 50
gnome-shell-43-4451GNOME 43 -> 44
gnome-shell-40-4242GNOME 40 -> 42
gnome-shell-3.36-3.3837GNOME 3.36 -> 3.38
gnome-shell-3.32-3.3433GNOME 3.32 -> 3.34
gnome-shell-3.10-3.30-GNOME 3.10 -> 3.30
gnome-shell-before-3.10-GNOME 3.4 -> 3.8

Installation from source

make build
make install
  • Restart the shell
  • Enable the extension

Screenshots & features

Scroll indicator icon

ScreenshotScreenshot

You can scroll on the indicator icon to enable / disable auto suspend:

  • Scroll up -> Filled cup: Caffeine enabled
  • Scroll down -> Empty cup: Caffeine disabled

Note: the option "Show status indicator" must be set on "always" (see below).

Notifications

Screenshot Screenshot

Timer option

This option enable Caffeine for a given amount of time (similar to Caffeine in LineageOS).

ScreenshotScreenshot

Preferences

Preferences

Command line support

Query the state:

  • gsettings --schemadir ~/.local/share/gnome-shell/extensions/caffeine@patapon.info/schemas/ get org.gnome.shell.extensions.caffeine cli-toggle

Enable / disable Caffeine:

  • gsettings --schemadir ~/.local/share/gnome-shell/extensions/caffeine@patapon.info/schemas/ set org.gnome.shell.extensions.caffeine cli-toggle true