Repository navigation
๐๏ธ EyesOnU - v1 Release
EyesOnU v1 is here!
Your new digital accountability partner that watches you through your webcam and reacts if you lose focus.
๐ v1 Release Features
- Focus Tracking โ Uses OpenCVโs face and eye detection to determine if youโre paying attention.
- Distraction Detection โ If you look away for more than 3 seconds, a reaction is triggered.
- Custom GIF Reactions โ Choose what happens when youโre distracted:
- Fullscreen AK-47 firing
- Explosions
- Cat slaps
- Or any GIF you provide!
- Sequential Reaction Playback โ Reactions cycle through your chosen GIF list.
- 10s Fullscreen Display โ Reactions fully take over your screen for maximum effect.
- Qt-based UI โ Start/stop sessions, choose camera, set delay, and manage GIFs without touching code.
- Cross-platform Support โ Works on Windows, Mac, and Linux.
๐ฆ Installation
git clone https://github.com/<your-username>/EyesOnU.git
cd EyesOnU
python -m venv .venv
# Activate virtual environment:
# Windows: .venv\Scripts\activate
# Mac/Linux: source .venv/bin/activate
pip install -r requirements.txt
โถ๏ธ How to Use
Launch:
python eyesonu_qt.py
In the app:
-
Refresh Cameras to detect your webcam.
-
Set Delay (seconds before reaction triggers).
-
Add GIFs to your reaction list.
-
Hit Start Session stay in frame and focused! All the best.
๐ Included in v1
-
Core distraction detection engine (OpenCV + Haar cascades)
-
GIF fullscreen player (imageio + OpenCV)
-
UI controls for session management
-
Basic configuration options (delay, camera index, FPS)
-
Sequential GIF playback
๐ Known Limitations in v1
-
No sound playback yet
-
No statistics or tracking dashboard
-CPU-heavy on low-end devices due to real-time detection
- Only detects distraction based on face/eye position (not posture or phone use)
๐ค License
MIT โ Free for personal and commercial use.

Suggestions?
contact me on X.
https://x.com/DheerajKumar76x
Download:
upload errors. will be available soon.