DEPRECATED. UNMAINTAINED. DO NOT USE. Fork of lp:caffeine that adds back a system tray status icon for toggling screen blanking and system suspend.
Switch branches/tags
Clone or download

README.md

DEPRECATED PROJECT, DO NOT USE

Caffeine Plus was created in response to the original Caffeine developer removing the tray icon UI for controlling Caffeine's behavior. Since then, he's added a companion app that restores the icon. This fork is no longer necessary or maintained.

Please use the original caffeine project and add caffeine-indicator to your startup applications to get the system tray icon.

The original README is shown below for archival purposes. This project is no longer maintained.

Caffeine Plus

Caffeine Plus is a small daemon that prevents the desktop from becoming idle (and hence the screen saver and/or blanker from activating). It does this automatically when the active window is full-screen, or on demand when enabled through its system tray icon.

This is a fork of Caffeine 2.7 which restores the system tray icon for toggling it on and off. Manual toggling is the primary use case for many users, but the original author is unwilling to restore that functionality.

I don't know Python, so this is a bit of copypasta from Caffeine 2.5 and the AppIndicator docs.

System requirements

  • Any Linux desktop system that offers the org.freedesktop.ScreenSaver DBus API. This includes, but is not limited to, Linux Mint 16 and Ubuntu 14.04. Probably works on lots of older distributions, too.

  • Python (Python 3 if you run it directly from the source tree w/o installing)

  • apt-get install python-xlib gir1.2-appindicator3-0.1 (python3-xlib if running w/o installing)

Installation

  • sudo python setup.py install --prefix /usr

  • (optional) To have Caffeine Plus run on startup, add it to your System Settings => Startup Programs list.

License

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

The Caffeine Plus status icons are Copyright (C) 2014 mildmojo (http://github.com/mildmojo), and distributed under the terms of the GNU Lesser General Public License, either version 3, or (at your option) any later version. See LICENSE.LESSER.

The Caffeine Plus SVG shortcut 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 LICENSE.LESSER.

Caffeine Plus uses pyewmh from http://sf.net/projects/pyewmh