Skip to main content

Caffeine

https://launchpad.net/caffeine/

Caffeine is a background program that prevents the desktop from becoming idle (and hence the screen saver or screen lock from activating) when the active window is full-screen.

Note that Caffeine currently only works on X11; this is a limitation of xdg-utils, which Caffeine uses to inhibit desktop idleness.

Also provided are an indicator, caffeine-indicator, that gives a manual toggle, and caffeinate, which allows desktop idleness to be inhibited for the duration of any command. See their man pages for more information.

Caffeine is distributed under the GNU General Public License, either version 3, or (at your option) any later version. See COPYING.

The Caffeine SVG icons are Copyright (C) 2009 Tommy Brunn (http://www.blastfromthepast.se/blabbermouth), and distributed under the terms of the GNU Lesser General Public License, either version 3, or (at your option) any later version. See COPYING.LESSER.

Caffeine requires the Python packages ewmh, python-xlib, and PyGObject, the C libraries Gtk3, AyatanaAppIndicator and Keybinder, and the xdg-utils command-line utilities.

Configuration

Caffeine Indicator’s global keyboard shortcut can be configured in dconf-editor at the path /org/sc3d/caffeine-indicator/binding. The default is Super+Ctrl+C (the “Super” key is typically the Windows key or equivalent).

Installation

Caffeine is distributed in Debian and its derivatives, where you can use your distribution’s software centre to install it, or in a terminal:

apt install caffeine

Caffeine is also available in the Python Package Index, under the name “cups- of-caffeine”, but installing the Python package does not currently take care of non-Python dependencies.

If you think you’ve found a bug

Try running, in a terminal:

window_id=`xwininfo | grep "Window id" | cut -d " " -f 4`

Now click on the terminal window, and then run:

xdg-screensaver suspend $window_id
xdg-screensaver resume $window_id

This performs the same steps at a lower level as turning Caffeine on then off again manually. If this gives the same problem as using Caffeine, then the bug is definitely not in Caffeine.

Testing translations

If you want to test out a translation without changing the language for the whole session, run caffeine as e.g.: LANGUAGE=ru ./caffeine

You will need a language pack for the given language. Be aware that some stock items will not be translated unless you log in with a given language.

Metadata

Release files for cups-of-caffeine 2.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cups-of-caffeine 2.10.1
File Size Uploaded
cups_of_caffeine-2.10.1.tar.gz 141.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cups-of-caffeine 2.10.1
File Interpreter ABI Platform
cups_of_caffeine-2.10.1-py3-none-any.whl Python 3 none any Details

Total release size: 203.6 kB

Release files / cups_of_caffeine-2.10.1.tar.gz

Download URL cups_of_caffeine-2.10.1.tar.gz
Size 141.6 kB
Tags Source
SHA-256 checksum
How to use checksums
a933c61a206f61c92acd4e6513104f2e9411e76b728309657d5287f5df5cb527
BLAKE2b-256 checksum
How to use checksums
7f8bbe331b50bddc2156f9c823c8af3748db50842074071121f0c31513ad68d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release files / cups_of_caffeine-2.10.1-py3-none-any.whl

Download URL cups_of_caffeine-2.10.1-py3-none-any.whl
Size 62.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0e46ece9420f5ea746aedaeae2544434dfa86fe910e50ec32def65cc6bd7eb04
BLAKE2b-256 checksum
How to use checksums
176e1e2e26cff59fbe17b956b304649399677376c598eb0d1d0655a61649251c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

2.10.1 This release

2 release files

2.10.0

2 release files

2.9.12

2 release files

2.9.11

2 release files

2.9.10

2 release files

2.9.9

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page