/caffeine

A fairly lightweight daemon that keeps your computer awake. Designed for rootless environments.

Primary LanguageCMIT LicenseMIT

Caffeine daemon

This is a really simple caffeine daemon for your linux system.

This works entirely without requiring root access and bypasses any imposed system management by emulating a mouse wiggle every few minutes.

Get started

Build the daemon & controller:

$ make install

This produces a caffeine artifact in the directory, and creates a folder in your ~/.config/ directory. You can then copy this onto your $PATH.

N.B. this requires xdotool at the moment.

Usage

Command Effect
caffeine daemon Start the caffeine daemon. Creates a lockfile in the caffeine config dir.
caffeine status Check if the daemon is running, and if it is, check if it is keeping the screen awake.
caffeine query Same as status, but returns an exit code instead of printing (for embedding).
caffeine start Start keeping the screen awake.
caffeine stop Stop keeping the screen awake.
caffeine toggle Toggle keeping the screen awake.
caffeine diagnostic Show some diagnostic information (daemon status, etc.)
caffeine version Show version.

Configuration

Check out the config.h file for configuration options.