Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

5 Commits

Repository files navigation

👁️ Blink — Eye care reminder for developers who forget to blink.

A lightweight system tray app that reminds you to blink, look away, and rest your eyes.


✨ Features

FeatureDescription
👁 Blink ReminderReminds you to blink every 30 seconds
👀 20-20-20 RuleEvery 20 minutes, look 20 feet away for 20 seconds
😌 Eye RestClose your eyes and rest after looking away
Pause/ResumeToggle reminders from the system tray menu
🐧 Native LinuxBuilt with GTK3 and AppIndicator

📦 Installation

sudo apt install python3-gi python3-yaml gir1.2-notify-0.7 -y
git clone https://github.com/OandONE/blink.git &&cd blink/blink
python3 blink.py

🚀 Autostart (run on boot)

mkdir -p ~/.config/autostart
cat >~/.config/autostart/blink.desktop << 'EOF'[Desktop Entry]Type=ApplicationName=BlinkComment=Eye care reminderExec=python3 /home/YOUR_USERNAME/blink/blink/blink.pyStartupNotify=falseTerminal=falseX-GNOME-Autostart-enabled=trueEOF

Replace YOUR_USERNAME with your Linux username.


🎨 Configuration

Edit ~/.config/blink/config.yaml:

blink_interval: 30# seconds between blink reminderslook_away_interval: 1200# seconds between 20-20-20 reminders (20 min)look_away_duration: 20# how long to look awayrest_duration: 20# how long to close your eyesenabled: true

🚧 Roadmap

  • ⚙️ Settings GUI
  • 🚀 Autostart option
  • 🎨 Custom notification sounds
  • 🪟 Windows support

📄 License

MIT © OandONE (2026)

About

👁️ Blink — Eye care reminder for developers who forget to blink.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages