SafeEyes/README.md

127 lines
3.8 KiB
Markdown
Raw Normal View History

2016-10-15 06:11:27 +02:00
# Safe Eyes
2017-10-07 18:06:04 +02:00
[![GitHub version](https://badge.fury.io/gh/slgobinath%2FSafeEyes.svg)](https://badge.fury.io/gh/slgobinath%2FSafeEyes)
[![PyPI version](https://badge.fury.io/py/safeeyes.svg)](https://badge.fury.io/py/safeeyes)
[![Translation status](https://hosted.weblate.org/widgets/safe-eyes/-/translations/svg-badge.svg)](https://hosted.weblate.org/engage/safe-eyes/?utm_source=widget)
2018-10-31 04:41:45 +01:00
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/slgobinath)
<!-- [![Badge](https://badges.debian.net/badges/debian/unstable/safeeyes/version.svg)](https://packages.debian.org/unstable/safeeyes) -->
2017-10-07 18:06:04 +02:00
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
Visit the official site: http://slgobinath.github.io/SafeEyes/ for more details.
2017-02-13 18:12:33 +01:00
2017-10-07 18:06:04 +02:00
## Safe Eyes command-line arguements
2018-03-30 20:23:56 +02:00
```text
2017-10-07 18:06:04 +02:00
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
2018-01-29 02:22:13 +01:00
--status print the status of running safeeyes instance and exit
2017-10-07 18:06:04 +02:00
--version show program's version number and exit
```
2017-04-22 15:00:28 +02:00
## Installation guide
2018-03-30 20:23:56 +02:00
2017-10-17 23:45:06 +02:00
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.
2016-10-25 17:20:23 +02:00
2017-10-17 23:45:06 +02:00
### Ubuntu, Linux Mint and other Ubuntu Derivatives
2018-03-30 20:23:56 +02:00
```bash
2017-10-17 23:45:06 +02:00
sudo add-apt-repository ppa:slgobinath/safeeyes
sudo apt update
sudo apt install safeeyes
```
### Arch
2018-03-30 20:23:56 +02:00
```bash
2017-10-17 23:45:06 +02:00
yaourt -S safeeyes
```
### Gentoo
2018-03-30 20:23:56 +02:00
```bash
2017-10-17 23:45:06 +02:00
sudo emerge -av x11-misc/safeeyes
```
### Debian
2018-03-30 20:23:56 +02:00
```bash
2018-06-26 19:37:57 +02:00
sudo apt-get install gir1.2-appindicator3-0.1 gir1.2-notify-0.7 python3-psutil python3-xlib xprintidle python3-pip
2017-10-17 23:45:06 +02:00
sudo pip3 install safeeyes
sudo update-icon-caches /usr/share/icons/hicolor
```
2018-03-30 20:23:56 +02:00
2018-06-26 19:37:57 +02:00
People using unstable/testing Debian can install Safe Eyes from the official repository using the following command:
2018-03-30 20:23:56 +02:00
```bash
2017-10-24 17:26:01 +02:00
sudo apt-get install safeeyes
```
2017-10-17 23:45:06 +02:00
### Fedora
2018-03-30 20:23:56 +02:00
```bash
2017-10-17 23:45:06 +02:00
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
2018-03-30 20:23:56 +02:00
2017-10-17 23:45:06 +02:00
Ensure to meet the following dependencies:
2017-05-03 21:04:13 +02:00
- gir1.2-appindicator3-0.1
- gir1.2-notify-0.7
- libappindicator-gtk3
- python3-psutil
- xprintidle (optional)
2017-10-17 23:45:06 +02:00
**To install Safe Eyes:**
2018-03-30 20:23:56 +02:00
```bash
2017-10-17 23:45:06 +02:00
sudo pip3 install safeeyes
```
2018-03-30 20:23:56 +02:00
2017-10-17 23:45:06 +02:00
After installation, restart your system to update the icons,
**To run from source:**
2018-03-30 20:23:56 +02:00
```bash
2017-10-17 23:45:06 +02:00
git clone https://github.com/slgobinath/SafeEyes.git
cd SafeEyes
python3 -m safeeyes
```
2018-03-30 20:23:56 +02:00
2017-10-17 23:45:06 +02:00
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.
2017-10-08 16:54:44 +02:00
## Features
2018-03-30 20:23:56 +02:00
2017-10-17 23:45:06 +02:00
- Remind you to take breaks with exercises to reduce RSI
2017-10-08 16:54:44 +02:00
- 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
2017-10-17 23:45:06 +02:00
- Customizable using plug-ins
2017-10-08 16:54:44 +02:00
2017-10-17 23:45:06 +02:00
## Third-party Plugins
2018-03-30 20:23:56 +02:00
2017-10-17 23:45:06 +02:00
Thirdparty plugins are available at another GitHub repository: [safeeyes-plugins](https://github.com/slgobinath/safeeyes-plugins). More details about how to write your own plugin and how to install third-party plugin are available there.
2017-10-08 16:54:44 +02:00
2017-04-18 17:55:57 +02:00
## License
2016-10-15 06:11:27 +02:00
GNU General Public License v3