Skip to content

Repository files navigation

Visara Logo

Visara

Desktop Eye Rest Timer and Guided Ocular Wellness Assistant

License: MIT Platform Electron GitHub Releases


Overview

Visara is an open-source desktop application designed to prevent digital eye strain and computer vision syndrome (CVS). Built around the clinically validated 20-20-20 rule, Visara provides non-intrusive timers, procedural Web Audio acoustic chimes, interactive 4-step guided ocular exercises, and an OLED-styled floating Dynamic Island Picture-in-Picture (PIP) widget.


Features

  • Automated 20-20-20 Intervals: Configurable work and rest cycles with visual countdown progress and background micro-rest scheduling.
  • Procedural Acoustic Synthesis: Real-time synthesized chimes (Gentle Chime, Tibetan Bowl, Marimba, Zen Bell, Water Drop) powered by the native Web Audio API with zero external audio assets.
  • Dynamic Island HUD: Minimalist always-on-top transparent widget with live status indicators, timer controls, and 14+ customizable animated loaders.
  • Guided Ocular Exercises: Interactive animated routines covering Circular Eye Rolling, Horizontal and Vertical Saccadic Tracking, and Lubricating Blink intervals.
  • 100% Offline and Private: All settings, timers, and activity streaks are processed and stored strictly locally on your machine with zero telemetry.
  • Global Hotkeys and System Tray: Manage rest cycles and timer modes seamlessly in the background.

Download and Installation

Pre-Built Binaries

Pre-compiled binaries for Windows, macOS, and Linux are available on the Releases page.

Operating System Package Format Description
Windows .exe (NSIS) Complete installer with custom path configuration and desktop shortcuts
Windows .exe (Portable) Standalone executable requiring no installation
macOS .dmg / .zip Universal disk image for Apple Silicon and Intel Macs
Linux .AppImage / .deb Portable AppImage and Debian package

Building from Source

Prerequisites

1. Clone the Repository

git clone https://github.com/Skandan-V/VISARA.git
cd VISARA

2. Install Dependencies

npm install

3. Run Locally

npm start

4. Build Distribution Packages

# Build for current OS
npm run dist

# Specific OS targets
npm run dist:win
npm run dist:mac
npm run dist:linux

Compiled binaries will be generated in the release/ directory.


Project Structure

VISARA/
├── .github/workflows/       # GitHub Actions CI/CD and Pages deployment
├── assets/                  # Application icons and branding assets
├── src/
│   ├── renderer/            # User interface and dashboard windows
│   │   ├── animations/      # CSS loaders and HUD animation styles
│   │   ├── index.html       # Main application window
│   │   ├── customization.html # Dynamic Island customization view
│   │   ├── exercise.html    # Guided ocular exercise view
│   │   └── island.html      # Floating Dynamic Island widget
│   ├── audio.js             # Procedural Web Audio synthesizer
│   ├── store.js             # Local preferences and streak storage
│   └── services/            # Client authentication and services
├── index.html               # Project marketing website (GitHub Pages)
├── installer.nsh            # Custom NSIS Windows installer script
├── main.js                  # Electron main process and lifecycle manager
├── preload.js               # Secure IPC context bridge
├── package.json             # Build configuration and scripts
├── LICENSE                  # MIT License
└── README.md                # Project documentation

Contributing

Contributions, bug reports, and suggestions are welcome.

  1. Fork the repository
  2. Create your branch (git checkout -b feature/NewFeature)
  3. Commit your changes (git commit -m 'feat: add NewFeature')
  4. Push to the branch (git push origin feature/NewFeature)
  5. Open a Pull Request

License

This project is licensed under the MIT License. See the LICENSE file for details.

Copyright (c) 2026 Skandan V (@Skandan-V)

About

An open-source desktop eye-care companion with smart break reminders, guided eye exercises, and a Dynamic Island countdown.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages