Protect Your Eyes From Eye Strain

SafeEyes is a simple, beautiful, and extensible break reminder that helps prevent eye strain when working long hours at the computer.

Install Now GitHub
SafeEyes Screenshot

Features

Break Reminders

Reminds you to take breaks with exercises to reduce RSI (Repetitive Strain Injury).

Keyboard Control

Option to disable keyboard during breaks to ensure you actually take them.

Smart Pause

Automatically pauses if the system is idle, avoiding unnecessary interruptions.

Multi-screen Support

Works seamlessly across multiple monitors.

Customizable UI

Personalize the user interface to match your preferences.

Plugin Support

Extend functionality with plugins to suit your needs.

Installation Guide

Safe Eyes is available on the official repositories of many popular Linux distributions. It is also available in Ubuntu PPA, Arch AUR and Python PyPI. Choose any installation source below for your Linux system.

Ubuntu/Linux Mint
Arch
Debian
Fedora
OpenSUSE
Flatpak
Other Linux

Ubuntu, Linux Mint and other Ubuntu Derivatives

Safe Eyes is available on the official repositories:

sudo apt install safeeyes

Also, the Official PPA for Safe Eyes hosts the latest version of safeeyes for Ubuntu 22.04 and above.

sudo add-apt-repository ppa:safeeyes-team/safeeyes
sudo apt update
sudo apt install safeeyes

Arch Linux

yay -S safeeyes

Debian

sudo apt-get install safeeyes
However, SafeEyes is not available on the official repositories for some versions of Debian, e.g. Trixie. There you can download a .deb package from GitHub releases.

Fedora

Available on the praiskup/safeeyes COPR maintained by @praiksup

sudo dnf -y copr enable praiskup/safeeyes
sudo dnf -y install python3-safeeyes

For smart pause plugin, you may have to install the latest xprintidle from: alonid/xprintidle

OpenSUSE Tumbleweed

sudo zypper refresh
sudo zypper install safeeyes

Flatpak

Warning: Many plugins and features don't work well in the flatpak. We recommend that you use one of the native packages listed above. Flatpak-only bugs should be reported at flathub/io.github.slgobinath.SafeEyes.

flatpak install flathub io.github.slgobinath.SafeEyes

Other Linux & Run from source

Ensure to meet the following dependencies:

  • gir1.2-notify-0.7
  • python3-babel
  • python3-croniter
  • python3-psutil
  • python3-packaging
  • python3-xlib
  • xprintidle (optional)
  • wlrctl (wayland optional)
  • Python 3.10+

To install Safe Eyes:

sudo pip3 install safeeyes

After installation, restart your system to update the icons.

To run from source:

git clone https://github.com/slgobinath/SafeEyes.git
cd SafeEyes
python3 -m safeeyes

Usage

Command-line Arguments

usage: safeeyes [-h] [-a | -d | -e | -q | -s | -t] [--debug] [--version]

Safe Eyes protects your eyes from eye strain (asthenopia) by reminding you to
take breaks while you're working long hours at the computer.

optional arguments:
  -h, --help        show this help message and exit
  -a, --about       show the about dialog
  -d, --disable     disable the currently running safeeyes instance
  -e, --enable      enable the currently running safeeyes instance
  -q, --quit        quit the running safeeyes instance and exit
  -s, --settings    show the settings dialog
  -t, --take-break  take a break now
  --debug           start safeeyes in debug mode
  --status          print the status of running safeeyes instance and exit
  --version         show program's version number and exit

Screenshots

Contribute

Develop

Contribute to the code by fixing bugs or adding new features. Check out the GitHub repository.

Translate

Help improve translations on Weblate. If your language is not available, open an issue.

Report Issues

Found a bug? Report it on the issue tracker.