d6f101d0c5
The translation "Asi" is nonsensical, so I have corrected it. |
||
---|---|---|
safeeyes | ||
LICENSE | ||
README.md |
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 Safe Eyes: 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:
hicolor-icon-theme
,libappindicator-gtk3
,xorg-xprop
,python2-xlib
,python2-gobject
andpython2-dbus
-
Debian:
gir1.2-appindicator3-0.1
,python-xlib
,python-gobject
,python-gi
andpython-dbus
-
Fedora 24:
libappindicator-gtk3
,python-xlib
,python-gobject
,xorg-x11-utils
andpython-dbus
2: Download and extract safeeyes.tar.gz into /
: sudo tar -xzvf safeeyes.tar.gz -C /
If you have any issues in installing Safe Eyes, please report them here
4: Start Safe Eyes using this command: /opt/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.
You can change the look and feel of the break screen in ~/.config/safeeyes/style/safeeyes_style.css
.
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
- Multi-monitor support
- Elegant and customizable design
- Multi-language support
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
Can you translate English to your mother tongue (or whatever the language)?
Show your support by translating Safe Eyes to a new language or by improving the existing translations.
Translating Safe Eyes
From version 1.1.0, Safe Eyes supports translation. Translation files for each langauges must be placed in /opt/safeeyes/config/lang
directory. The language file name must follow ISO 639-1 language code standard. For example, the language file of English must be en.json
. Follow these steps to translate Safe Eyes to your language.
-
Copy
/opt/safeeyes/config/lang/en.json
to/opt/safeeyes/config/lang/<iso-639-1-language-code>.json
-
Provide
language_name
in the language itself andlanguage_name_en
in English. -
Translate other property values to the selected language.
Note 1: The {}
used in property values will be replaced by runtime variables related to those commands. For example the {}
in Next break at {}
will be replaced by time at the runtime.
Note 2: Use Unicode when translating Safe Eyes.
Note 3: To change the language of Safe Eyes, change the language
property in ~/.config/safeeyes/safeeyes.json
to the ISO 639-1 code of your language and restart the Safe Eyes.
For more details, have a look at existing language files: lang
Currently available translations
History
Version 1.1.1:
- About dialog
- UI control to select the language
- Fixed bug in disable option after suspend
Version 1.1.0:
- Multi-language support
- Fixed bug in multi-screen support
- Fixed bug in break screen transparency
- Next break information in tray menu
Version 1.0.9:
- Multi-screen support
- Handling system suspend (Stop and restart during system suspend)
Version 1.0.8:
- Bug fix for Ubuntu Mate
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
- Ubuntu Mate 16.04
License
GNU General Public License v3