Overview
Contributions are welcome! Feel free to open issues or submit pull requests. Contributions for improving the dashboard, enhancing customizability, and adding new languages for multilingual support are particularly appreciated.
Blink Eye is built on open-source principles to guarantee security, privacy, and full reproducibility. All sensitive data transformations run locally on your hardware with zero telemetry or unexpected cloud dependencies.
Key Technical Features & Capabilities
Customizable reminder timers.: High-performance integrated capability designed for native Blink Eye workflow.
Rich library of customizable reminder screens.: High-performance integrated capability designed for native Blink Eye workflow.
Full-screen popups with a 20-second countdown to prompt users to look away.: High-performance integrated capability designed for native Blink Eye workflow.
Customizable dashboard for settings and preferences.: High-performance integrated capability designed for native Blink Eye workflow.
Usage time tracking, can see daily, weekly, and lifetime usage stats.: High-performance integrated capability designed for native Blink Eye workflow.
All future feature updates based on community feedback.: High-performance integrated capability designed for native Blink Eye workflow.
Multilingual support. [Soon]: High-performance integrated capability designed for native Blink Eye workflow.
Audio mute during reminders to enhance focus. [Soon]: High-performance integrated capability designed for native Blink Eye workflow.
Architecture & Technology Stack
Primary Languages: Rust, TypeScript
Frameworks & UI Runtime: Tauri 2
Build Systems & Tooling: Cargo, pnpm / npm
Supported Platforms: macOS 12.0+ (Apple Silicon M1-M4 & Intel x86_64), Windows 10/11 x64, Linux
System Requirements
| Specification | Minimum Requirement | Recommended Specification |
|---|
| Operating System | macOS 12.0 Monterey / Windows 10 x64 | macOS 14.0+ Sonoma / Windows 11 x64 |
| Processor Architecture | Apple Silicon (M1+) or Intel Core i5 x64 | Apple Silicon Unified Memory (M2/M3/M4) |
| Memory (RAM) | 4 GB Unified RAM | 8 GB+ High-Speed RAM |
| Storage Space | 300 MB available local disk space | 1 GB+ SSD storage |
| GPU Acceleration | Metal 2 / DirectX 12 compatible | Apple Neural Engine / Vulkan capable |
Installation & Setup Guide
macOS Installation (Recommended)
1Download the verified .dmg release installer directly from CookApps.
2Open the disk image and drag Blink Eye.app into your /Applications folder.
3Launch Blink Eye via Spotlight (Cmd + Space) or Launchpad.
Alternatively, install using Homebrew if available:
brew install --cask blink-eye
Windows Installation
1Download the official installer package (.exe / .msi).
2Run the executable and follow the setup wizard.
3Launch Blink Eye from the Start Menu or desktop shortcut.
Building from Source (Development Setup)
git clone https://github.com/nomandhoni-cs/blink-eye.git
cd blink-eye
pnpm install || cargo build --release
pnpm run build
How to Use & Workflow
1Application Launch & Workspace: Open Blink Eye to load the responsive native workspace.
2Configuration & Preferences: Press Cmd + , (macOS) or Ctrl + , (Windows) to configure hardware acceleration, custom directories, and display themes.
3Primary Operation: Drag-and-drop source files or input parameters directly into the central window.
4Execution & Export: Initiate the processing pipeline and verify output files saved directly to your chosen local directory.
Troubleshooting & Common Issues
Problem: macOS Gatekeeper displays *"App is damaged and can't be opened"* or unnotarized developer notice.
Root Cause: macOS quarantine flag set on binaries downloaded outside the Mac App Store.
Resolution: Open Terminal and run:
xattr -cr /Applications/Blink Eye.app
Alternatively, navigate to System Settings > Privacy & Security and select Open Anyway.
Problem: High memory consumption during batch processing operations.
Root Cause: Large media buffers retaining uncompressed state.
Resolution: Adjust batch concurrency in settings or process assets in focused batches.