Very nimble OS X utility that reminds you to take a break
Switch branches/tags
Nothing to show
Clone or download
pirafrank typo fix
Signed-off-by: Francesco Pira <>
Latest commit fa1d04e Aug 18, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE added LICENSE Aug 17, 2015 added readme Aug 17, 2015
eyerelief typo fix Aug 17, 2015

Eye Relief

A very nimble utility to remember you to give your eyes a break.


I spend a lot of time programming and it's hard to track time to apply the 20-20-20 rule.

How it works

A short bash script is copied in /usr/local/bin and it is executed every 8 minutes by the built-in OS X utility Launchd (an Apple equivalent of Linux crontab).

Every 20 minutes it sends a notification as a reminder for you.

That's why it's very nimble: it uses what's OS X already has!


Although the 20-20-20 rule is widely known, this utility is given WITHOUT ANY KIND OF WARRANTY on your health.


OS X 10.8 or above (due the need of notification center!).

Tested on Mavericks and Yosemite.


Step 0: download the repo as zip file, then unzip it. Open terminal in newly unzipped folder.

Step 1: sudo cp eyerelief /usr/local/bin/eyerelief

Step 2: sudo chmod +x /usr/local/bin/eyerelief

Step 3: cp com.fpira.eyerelief.plist ~/Library/LaunchAgents/

Step 4: launchctl load ~/Library/LaunchAgents/com.fpira.eyerelief.plist

What's next

  • Installer (.pkg)
  • ON/OFF toggle option
  • User's customization: Battery ranges ?
  • Linux support ?


The software in this repository are released under the GNU GPLv3 License by Francesco Pira (dev[at]fpira[dot]com, You can read the terms of the license here.