2016-10-15 06:11:27 +02:00
# Safe Eyes
2017-04-28 19:54:05 +02:00
Protect your eyes from eye strain using this simple and beautiful, yet extensible break reminder. A Free and Open Source Linux alternative to EyeLeo.
2016-10-15 06:11:27 +02:00
2017-04-18 17:55:57 +02:00
Visit to the official site: http://slgobinath.github.io/SafeEyes/ for more details.
2017-02-13 18:12:33 +01:00
2017-04-22 15:00:28 +02:00
## Installation guide
Safe Eyes is available in Ubuntu PPA, Arch AUR and Python PyPI. You can choose any installation source and install on any Linux system with Python 3. To see how to install Safe Eyes, visit [Getting Started ](http://slgobinath.github.io/SafeEyes/#introduction )
2016-10-25 17:20:23 +02:00
2017-05-03 21:04:13 +02:00
### Compile from source
Ensure to meet the following dependencies when compiling from source:
- gir1.2-appindicator3-0.1
- gir1.2-notify-0.7
- libappindicator-gtk3
- python3-pyaudio
- python3-psutil
- xprintidle (optional)
2017-04-22 15:00:28 +02:00
## Customizing options
One of the key advantage of Safe Eyes over other similar products is its highly customizable design. You can change almost everything in Safe Eyes. A detailed documentation is available in the official site: [Customize Safe Eyes ](http://slgobinath.github.io/SafeEyes/#customize )
2016-10-23 18:55:08 +02:00
2017-04-22 15:00:28 +02:00
## Contribute
I started this project for my own use and later released it as an open source alternative to EyeLeo and progressively reached to the current state with the great support of open source community. Most of the creative ideas were suggested and implemented by users. You can always add more to Safe Eyes. I have listed some possible ways here: [How to contribute ](http://slgobinath.github.io/SafeEyes/#contribute )
2017-04-15 21:13:01 +02:00
2017-04-18 17:55:57 +02:00
## Features
2017-02-12 17:44:48 +01:00
General Features:
2016-10-15 06:11:27 +02:00
- Short breaks with eye exercises
- Long breaks to change physical position and to warm up
2016-10-23 14:34:24 +02:00
- Disable the keyboard during break
2016-10-15 06:11:27 +02:00
- Notifications before every break
2017-04-15 16:34:54 +02:00
- Do not disturb when working with full-screen applications( Eg: Watching movies)
2017-04-22 15:00:28 +02:00
- Smart pause and resume based on system idle time (Require `xprintidle` )
2016-11-15 14:46:56 +01:00
- Multi-monitor support
- Multi-language support
2017-04-22 15:00:28 +02:00
- Elegant and customizable design
2017-02-12 17:44:48 +01:00
Optional Features:
- Strict break for those who are addicted to computer
2017-04-25 21:43:25 +02:00
- Postpone break
2017-04-15 16:34:54 +02:00
- Skip or take break based on active windows (Regardless of full-screen-mode)
2017-02-12 17:44:48 +01:00
- Customize individual break time
2017-04-22 15:00:28 +02:00
- Define your own custom exercise
2017-02-12 17:44:48 +01:00
- Audible alert at the end of break
- Turn on/off audible alert for individual breaks
- Customize disable time period
2017-04-22 15:00:28 +02:00
- Lock screen after long breaks
2017-04-25 21:43:25 +02:00
- Add images to breaks
2017-04-15 16:34:54 +02:00
- Plug-in support to extend Safe Eyes
2017-02-12 17:44:48 +01:00
2017-04-22 15:00:28 +02:00
For more details: [SafeEyes Features ](http://slgobinath.github.io/SafeEyes/#features )
2016-10-15 06:11:27 +02:00
2017-04-18 17:55:57 +02:00
## Currently available translations
2017-04-03 20:29:21 +02:00
* [Čeština ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/cs.json )
* [Deutsch ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/de.json )
* [English ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/en.json )
* [Español ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/es.json )
* [Français ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/fr.json )
* [ქართული ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/ge.json )
* [हिंदी ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/hi.json )
* [Magyar ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/hu.json )
* [Bahasa Indonesia ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/id.json )
2017-04-25 21:43:25 +02:00
* [Polski ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/pl.json )
2017-04-03 20:29:21 +02:00
* [Português ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/pt.json )
* [Русский ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/ru.json )
* [Slovenský ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/sk.json )
* [தமிழ் ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/ta.json )
* [Türkçe ](https://github.com/slgobinath/SafeEyes/tree/master/safeeyes/config/lang/tr.json )
2017-01-10 13:32:57 +01:00
2017-04-22 15:00:28 +02:00
Do you want to see your language here? Please translate Safe Eyes to whatever the languages you know. Visit to **Translate Safe Eyes** in [Customize Safe Eyes ](http://slgobinath.github.io/SafeEyes/#customize ) to see how to translate.
2017-01-10 13:32:57 +01:00
2017-04-18 17:55:57 +02:00
## Tested Environments
2017-01-10 13:32:57 +01:00
2017-04-22 15:00:28 +02:00
Core functionalities of Safe Eyes are tested by the developer in the following environments:
* Antergos 17.4
* Elementary OS Loki
* Fedora 25
* Kubuntu 17.04
* Linux Mint 18.1
* Manjaro 16.10.3
* Ubuntu 14.04
* Ubuntu 16.04
* Ubuntu 16.10
* Ubuntu Budgie 17.04
* Ubuntu Mate 16.04
* Xubuntu 16.10
2016-10-15 06:11:27 +02:00
2017-04-18 17:55:57 +02:00
## License
2016-10-15 06:11:27 +02:00
2016-10-25 18:11:21 +02:00
GNU General Public License v3
