Tray bar application able to temporarily inhibits the screensaver and sleep mode.
Go to file
Martino Fontana d0ac3a74ee Fix hardcoded /etc
Fixes: #142
Co-authored-by: Hugo Osvaldo Barrera<>
2023-08-14 22:37:27 +02:00
bin Avoid hardcoded python path 2022-07-31 10:38:31 +02:00
caffeine Tweak some type hints 2023-07-10 16:08:37 +02:00
scripts Don't force long descriptions for versions 2023-03-11 15:54:31 +01:00
share Update the man page 2022-07-31 22:32:39 +02:00
translations Fix some typos in Czech translations 2023-02-02 23:19:31 +01:00
.gitignore Switch to meson for building / packaging 2022-07-26 19:53:05 +02:00
.pre-commit-config.yaml Update pre-commit hooks 2023-05-07 13:05:51 +02:00
.woodpecker.yml Create [fake] tag when publishing 2022-07-13 19:44:14 +02:00
CHANGELOG.rst Drop single instance logic 2023-07-10 15:23:39 +02:00
LGPL Renamed licenses according to their name. 2014-10-18 14:13:21 -03:00
LICENCE Rename GPL to LICENCE 2017-01-22 10:13:25 -03:00 Rewrite README into markdown 2022-08-13 19:24:09 +02:00
caffeine.1.scd man: fix bad syntax in synopsis 2023-07-10 16:08:20 +02:00 Fix hardcoded /etc 2023-08-14 22:37:27 +02:00
pyproject.toml Move mypy config into pyproject.toml 2023-03-07 11:35:18 +01:00


build status licence

Caffeine is a little daemon that sits in your systray, and prevents the screensaver from showing up, or the system from going to sleep. It does so when an application is fullscreened (eg: youtube), or when you click on the systray icon (which you can do, when, eg: reading).


Caffeing-ng (since 2014) started as a fork of [Caffeine 2.4], since the original version dropped support for the systray icon in favour of only automatic detection of fullscreen apps only, which turned to be a rather controversial decision.

The intention of this fork is to also evolve on its own, not only fixing issues, but also implemented missing features, when relevant.

Caffeine-ng was shortly know as Taurine, a play on its successor's name, since taurine is a known stimulant, commonly found in energy drinks. However, this name did not last, since the artwork would not match adequately, and changing it was undesirable.

System requirements

  • Python 3.6 to 3.10 is required.
  • caffeine-ng works with the following screensavers / screenlockers:
    • Anything that implements the org.freedesktop.ScreenSaver API (this includes KDE, amongst others)
    • gnome-screensaver
    • XSS
    • Xorg + DPMS
    • xautolock
    • xidlehook.



On ArchLinux, caffeine-ng is available at the AUR.

Debian and derivatives

First install all the required packages:

  apt install meson \
    python-gi-dev \
    python-dbus-dev \
    libgtk-3-dev \
    libnotify-dev \
    libappindicator3-dev \
    python3-click \
    python3-ewmh \
    python3-setproctitle \
    python3-pulsectl \
    git \

And mark them auto if you wish:

  apt-mark auto meson \
    ...same list as above...

Then you need to build sources with:

  meson build
  ninja -C build

Create a package for your distribution:

  checkinstall \
    --pkgname=caffeine-ng \
    --pkgversion=4.1 \
    --requires="python3-gi,python3-dev,libgtk-3-0,libnotify4,libappindicator3-1,python3-click,python3-ewmh,python3-setproctitle," \
    --conflicts="caffeine" \
    --nodoc \
    meson install -C build

Replace version string with correct version and append this command with --install=no should you wish to inspect created package before installing it.

checkinstall is available for various distributions, so you may follow these steps adapting them to your distribution

For additional discussion on building DEB packages, see:


Gentoo users may find caffeine-ng in ::pf4public Gentoo overlay.

Others / from source

To manually install caffeine-ng, run:

  meson build
  ninja -C build
  sudo meson install -C build
  sudo glib-compile-schemas /usr/share/glib-2.0/schemas

Note for packagers

Generally, package manager handle running glib-compile-schemas themselves, so this doesn't need to be triggered explicitly.

To install into /usr/ rather than /usr/local/, instead of running meson build run meson --prefix /usr build.

See for details.


To have Caffeine-ng run on startup, add it to your System Settings => Startup Programs list.


To generate the pot file use::

find . -iname "*.py" -o -iname "*.glade" | \
xargs xgettext --from-code utf-8 -o translations/caffeine.pot


Copyright (C) 2014-2022 Hugo Osvaldo Barrera Copyright (C) 2009 The Caffeine Developers

Caffeine-ng is distributed under the GNU General Public License, either version 3, or (at your option) any later version. See LICENCE for details.

The Caffeine-ng status icons are Copyright (C) 2014 mildmojo (, and distributed under the terms of the GNU Lesser General Public License, either version 3, or (at your option) any later version. See LGPL.

The Caffeien-ng SVG shortcut icons are Copyright (C) 2009 Tommy Brunn (, and distributed under the terms of the GNU Lesser General Public License, either version 3, or (at your option) any later version. See LGPL.


  • To run: ./bin/caffeine
  • To compile translations: ./update_translations

If you want to test out a translation without changing the language for the whole session: LANG=ru_RU.UTF-8 ./bin/caffeine (Replace ru_RU.UTF-8 with whichever language you want to use. You will need to a language pack for the specific language) Be aware that some stock items will not be translated unless you log in with a given language.