miracle091/SafeEyes
miracle091/SafeEyes
1
0
Fork 0
mirror of https://github.com/slgobinath/SafeEyes.git synced 2024-12-27 00:02:36 +01:00
Code Issues Releases Wiki Activity
Proteggi i tuoi occhi dall'affaticamento tramite un reminder visivo e configurabile https://slgobinath.github.io/SafeEyes/
497 Commits 7 Branches 44 Tags 12 MiB
Python 98.8%
CSS 1.1%
Shell 0.1%
91a0f093bb
Go to file
anonymous 91a0f093bb Translated using Weblate (Ukrainian) 
Currently translated at 2.1% (2 of 92 strings)

Translation: Safe Eyes/Translations
Translate-URL: https://hosted.weblate.org/projects/safe-eyes/translations/uk/
2018-01-22 22:16:29 +01:00
debian Prepare for Ubuntu build 2018-01-12 17:58:11 -05:00
safeeyes Translated using Weblate (Ukrainian) 2018-01-22 22:16:29 +01:00
share language: add Estonian language into desktop file 2017-07-18 22:26:20 +03:00
.gitignore Add option to interpret system idle as break 2017-10-17 14:50:57 -04:00
LICENSE Initial commit 2016-01-08 12:45:22 +05:30
MANIFEST.in Prepare alpha version 1.2.0a7 release 2017-04-15 08:54:00 -04:00
README.md Add Debian badge to readme 2017-10-24 11:26:01 -04:00
setup.cfg Prepare alpha version 1.2.0a1 release 2017-04-14 18:07:05 -04:00
setup.py Prepare for Ubuntu build 2018-01-12 17:58:11 -05:00

README.md

Safe Eyes

GitHub version PyPI version Translation status Badge

Protect your eyes from eye strain using this simple and beautiful, yet extensible break reminder. A Free and Open Source Linux alternative to EyeLeo.

Visit to the official site: http://slgobinath.github.io/SafeEyes/ for more details.

Safe Eyes command-line arguements

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
  --version         show program's version number and exit

Installation guide

Safe Eyes is available in Ubuntu PPA, Arch AUR, Gentoo and Python PyPI. You can choose any installation source and install on any Linux system with Python 3.

Ubuntu, Linux Mint and other Ubuntu Derivatives

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

Arch

yaourt -S safeeyes

Gentoo

sudo emerge -av x11-misc/safeeyes

Debian

sudo apt-get install gir1.2-appindicator3-0.1 gir1.2-notify-0.7 python3-psutil python3-xlib xprintidle
sudo pip3 install safeeyes
sudo update-icon-caches /usr/share/icons/hicolor

People using unstable/testing Debian can install Safe Eyes froms the official repository using the following command:

sudo apt-get install safeeyes

Fedora

sudo dnf install libappindicator-gtk3 python3-psutil
sudo pip3 install safeeyes
sudo gtk-update-icon-cache /usr/share/icons/hicolor

Other Linux & Run from source

Ensure to meet the following dependencies:

  • gir1.2-appindicator3-0.1
  • gir1.2-notify-0.7
  • libappindicator-gtk3
  • python3-psutil
  • xprintidle (optional)

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

Safe Eyes installers install the required icons to /usr/share/icons/hicolor. When you run Safe Eyes from source without, some icons may not appear.

Features

  • Remind you to take breaks with exercises to reduce RSI
  • Disable keyboard during breaks
  • Notification before and after breaks
  • Smart pause if system is idle
  • Multi-screen support
  • Customizable user interface
  • RPC API to control externally
  • Command-line arguments to control the running instance
  • Customizable using plug-ins

Third-party Plugins

Thirdparty plugins are available at another GitHub repository: safeeyes-plugins. More details about how to write your own plugin and how to install third-party plugin are available there.

License

GNU General Public License v3