5.9 KiB

Raw Blame History

Safe Eyes

Protect your eyes from eye strain using this continuous breaks reminder. A Free and Open Source Linux alternative for EyeLeo.

For more details: SafeEyes Protects You From Eye Strain When Working On The Computer

Installation

Ubuntu:

1: Add the PPA: sudo add-apt-repository ppa:slgobinath/safeeyes

2: Download the package list: sudo apt update

3: Install uget-chrome-wrapper: sudo apt install safeeyes

4: Start Safe Eyes from start menu.

Arch:

Install SafeEyes via AUR. Credits to Yamakaky

Other Linux:

Manual installation is not tested in any systems. I will update this page as soon as I have tested in any other Linux distributions.

1: Install the dependencies:

Arch: gir1.2-appindicator3-0.1, python-xlib, python-gobject, python-gi and xorg-xprop
Fedora 24: libappindicator-gtk3, python-xlib, python-gobject and xorg-x11-utils

2: Download and extract safeeyes.tar.gz into /: sudo tar -xzvf safeeyes.tar.gz -C /

The following files are deployed by SafeEyes

opt/
opt/safeeyes/
opt/safeeyes/BreakScreen.py
opt/safeeyes/config/
opt/safeeyes/config/safeeyes.json
opt/safeeyes/config/style/
opt/safeeyes/config/style/safeeyes_style.css
opt/safeeyes/glade/
opt/safeeyes/glade/break_screen.glade
opt/safeeyes/glade/settings_dialog.glade
opt/safeeyes/Notification.py
opt/safeeyes/safeeyes
opt/safeeyes/SafeEyesCore.py
opt/safeeyes/SettingsDialog.py
opt/safeeyes/TrayIcon.py
usr/
usr/share/
usr/share/applications/
usr/share/applications/safeeyes.desktop
usr/share/icons/
usr/share/icons/hicolor/
usr/share/icons/hicolor/128x128/
usr/share/icons/hicolor/128x128/apps/
usr/share/icons/hicolor/128x128/apps/safeeyes.png
usr/share/icons/hicolor/16x16/
usr/share/icons/hicolor/16x16/status/
usr/share/icons/hicolor/16x16/status/safeeyes_disabled.png
usr/share/icons/hicolor/16x16/status/safeeyes_enabled.png
usr/share/icons/hicolor/24x24/
usr/share/icons/hicolor/24x24/status/
usr/share/icons/hicolor/24x24/status/safeeyes_disabled.png
usr/share/icons/hicolor/24x24/status/safeeyes_enabled.png
usr/share/icons/hicolor/32x32/
usr/share/icons/hicolor/32x32/apps/
usr/share/icons/hicolor/32x32/apps/safeeyes.png
usr/share/icons/hicolor/32x32/status/
usr/share/icons/hicolor/32x32/status/safeeyes_disabled.png
usr/share/icons/hicolor/32x32/status/safeeyes_enabled.png
usr/share/icons/hicolor/48x48/
usr/share/icons/hicolor/48x48/apps/
usr/share/icons/hicolor/48x48/apps/safeeyes.png
usr/share/icons/hicolor/48x48/status/
usr/share/icons/hicolor/48x48/status/safeeyes_disabled.png
usr/share/icons/hicolor/48x48/status/safeeyes_enabled.png
usr/share/icons/hicolor/64x64/
usr/share/icons/hicolor/64x64/apps/
usr/share/icons/hicolor/64x64/apps/safeeyes.png

If you have any issues in installing Safe Eyes, please report them here

4: Start Safe Eyes using this command: /opt/safeeyes/safeeyes/safeeyes

Once started, Safe Eyes will copy the desktop file to ~/.config/autostart and the configurations to ~/.config/safeeyes. Therefore, from next time onwards, it should start with the system.

Configuring Safe Eyes

Just install and forget; Safe Eyes will take care of your eyes. To customize the preferences, go to Settings from Safe Eyes tray icon. For advanced configuration, go to ~/.config/safeeyes folder. There you can change the Skip button text in safeeyes.json and the look and feel of the break screen in style/safeeyes_style.css. If you want to add more exercises, you can add them in the safeeyes.json. A sample configuration is given below for your reference:

{
    "break_interval": 15, 
    "long_break_duration": 60, 
    "long_break_messages": [
        "Walk for a while", 
        "Lean back at your seat and relax",
        "Long break exercise 1",
        "Long break exercise 2"
    ], 
    "no_of_short_breaks_per_long_break": 5, 
    "pre_break_warning_time": 10, 
    "short_break_duration": 15, 
    "short_break_messages": [
        "Tightly close your eyes", 
        "Roll your eyes", 
        "Rotate your eyes", 
        "Blink your eyes", 
        "Have some water",
        "Short break exercise 1",
        "Short break exercise 2"
    ], 
    "skip_button_text": "Cancel", 
    "strict_break": false
}

Uninstalling Safe Eyes

Use the following commands to uninstall SafeEyes from your system.

sudo apt remove safeeyes
rm -r ~/.config/safeeyes
rm ~/.config/autostart/safeeyes.desktop

Features

Short breaks with eye exercises
Long breaks to change physical position and to warm up
Strict break for those who are addicted to computer
Highly customizable
Do not disturb when working with fullscreen applications( Eg: Watching movies)
Disable the keyboard during break
Notifications before every break
Multi-workspace support
Elegant and customizable design

Contributing

Are you a user?

Please test Safe Eyes on your system and report any issues here

Are you a developer?

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request

Are you using a different Linux system?

Please test Safe Eyes and create installers for your operating system

History

Version 1.0.7:

Removed python-apscheduler dependency
Installation directory is restructured
Bug fixes:
- Supporting Ubuntu 16.10
- Symlink for autostart instead of copying the desktop file

Version 1.0.6:

Latest stable release

Tested Environments

Ubuntu 14.04
Ubuntu 16.04
Ubuntu 16.10
Linux Mint 18

License

GNU General Public License v3

5.9 KiB Raw Blame History