blinkwell is an on-device eye-fatigue monitor. Every ~10 minutes it opens your camera for a 60-second check — blink dynamics, eyelid closure, partial blinks — then tells you when it's time for a break and what to do about it. Nothing ever leaves your machine.
The camera opens for ~60 s every ~10 min — never continuously, and fully released between windows. Your webcam LED is the honest signal.
MediaPipe Face Landmarker runs locally; frames are processed in memory and discarded instantly. Look away mid-check and the clock pauses — only aligned time counts.
When fatigue signals rise vs. your baseline, blinkwell suggests a 20-20-20 break, palming, or full-blink exercises — timed, guided, optional.
blinkwelljust this — it asks once, then monitors: ~60 seconds every ~10 minutes (adjustable)blinkwell --oncea single guided check right now, then exitsblinkwell historyshows your past checks and trends in the terminalblinkwell reportopens a page with charts of all your checksblinkwell --help lists every option, including how often and how long checks run.
history.jsonl in your home
folder — one line of numbers per check.No. Frames are analyzed in memory and discarded the instant they're measured — nothing is uploaded, nothing is saved. What remains is one line of numbers per check.
No — about 60 seconds every 10 minutes. The camera opens for the check and is released right after; your camera's indicator light shows you exactly when it's live.
Everything lives in one folder in your home directory:
~/.blinkwell on Mac and Linux,
%USERPROFILE%\.blinkwell on Windows. Delete that folder and
your whole history is gone — there's no account and nothing on a server
to clean up.
Free and open-source (MIT). No account, no email, no sign-up — install and run.
Yes — Windows (x64 and ARM64), Apple-Silicon Macs and Linux x86_64 get the native app; Intel Macs and Linux ARM run the same program through a one-command Python fallback. The install box above picks the right one for you.