caffeine

Keep computer awake by moving the cursor by 1 pixel back and forth every few seconds

Table of Contents

• Features
• Usage
• Development and Testing
  • Setup
  • Running Unit Tests
  • Build
  • Other Tasks
• License
• Support

Features

• System tray application with start/stop controls
• Configurable interval (5s, 15s, 30s, 45s, 60s) from the tray menu
• Cross-platform (Linux, Windows)
• Standalone executable via PyInstaller

Usage

# Run from source
uv run python -m caffeine

Or download the latest standalone executable from Releases.

The app runs in the system tray. Right-click the tray icon to start, stop, change the interval, or quit.

Development and Testing

Requires UV to be installed.

Setup

uv lock --upgrade && uv sync --all-extras --all-groups

Running Unit Tests

poe test

Build

Build a standalone executable with PyInstaller:

poe build

The executable will be generated in the ./dist directory.

Other Tasks

poe linter

poe updatedev

License

Released under the MIT License

Support

If you find this project helpful, consider supporting development.