Thanks to visit codestin.com
Credit goes to github.com

Skip to content

README.md

Latest commit

 

History

History
144 lines (99 loc) · 3.73 KB

README.md

File metadata and controls

144 lines (99 loc) · 3.73 KB

Blinkr: Protect Your Eyes, One Blink at a Time 👁️💡

blinkr-high-resolution-logo

A lightweight desktop app that reminds you to blink and take short breaks — helping reduce eye strain during long work sessions.
Available for macOS and Windows.

✨ Features

  • 🕒 Smart break reminders with configurable intervals
  • 👁️ Automatic blink reminders
  • 🔊 Optional sound notifications
  • 🎨 Minimal and clean UI
  • 🔄 Runs silently in the background
  • 🚀 Extremely lightweight and optimized for long work sessions

📸 App Preview

preview-1

preview-2

preview-3

📥 Downloads

You can download the installers directly:

✅ macOS

🔗 Download macOS Installer (.dmg)
👉 Blinkr-0.2.0.dmg (https://github.com/varundhand/Blinkr/releases/download/v0.2.0/Blinkr-0.2.0.dmg)

✅ Windows

🔗 Download Windows Installer (.exe)
👉 Blinkr-0.2.0.exe (https://github.com/varundhand/Blinkr/releases/download/v0.2.0/Blinkr.Setup.0.2.0.exe)

Both versions may show security warnings since I do not own code-signing certificates (Apple Developer ID or Windows Authenticode).
These warnings are expected — the app is safe to use.

🛠 Installation

macOS Installation (Important)

Because the app is not signed (Apple charges for Developer certificates), macOS will block the app on first launch.

Follow this:

  1. Download the .dmg
  2. Drag Blinkr into the Applications folder
  3. Try opening it — you will see:
    “Blinkr cannot be opened because the developer cannot be verified.”
  4. Go to:
    System Settings → Privacy & Security
  5. Scroll down until you see:
    “Blinkr was blocked from opening”
  6. Click Allow Anyway
  7. Now right-click the Blinkr app → Open
  8. Click Open again

✅ Now it will work normally without warnings

Windows Installation

Windows SmartScreen will warn you because the app is not code-signed (certificate is expensive).

  1. Download the .exe
  2. Run the installer
  3. When SmartScreen appears:
    • Click More info
    • Click Run anyway
  4. Install and use normally

✅ After first time, no warnings will appear again.

🔧 Tech Stack

  • Electron
  • Vite
  • React + TypeScript
  • Tailwind / Custom CSS
  • Node.js

🚀 Development Setup

# Install dependencies
npm install

# Start dev environment
npm run dev

# Build production binaries
npm run build

Package output will appear in your dist/ or release/ folders depending on your setup.

📝 Changelog (v0.2.0)

  • 🎨 Improved overlay visuals
  • 🔊 Fixed sound playback for blink/break reminders
  • ⏰ More accurate scheduling + timers
  • 🪟 Corrected window behavior during overlay
  • 🔄 Improved background lifecycle stability

📄 License

The app is not code-signed on macOS or Windows.
You may see installation warnings — this is expected.

👤 Author

Varun Dhand
Creator of Blinkr — Your Eye Health Companion 👁️✨