health-protect-extension

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

health-protect-extension

★ 12 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Health Protect 🩺

A comprehensive **Chrome (Manifest V3) extension** that protects your eyes, posture,
joints and overall wellbeing when you use a PC all day.

It turns the proven habits for desk workers into gentle, customizable reminders:

| Reminder | Default | What it does |
|----------|---------|--------------|
| 👁️ Eye break (20-20-20) | every 20 min | Full-screen 20-second break — look ~6 m / 20 ft away |
| 😌 Blink & relax | every 10 min | Reminds you to blink fully (prevents dry eyes) |
| 💧 Hydrate | every 45 min | Drink some water |
| 🪑 Posture check | every 30 min | Sit back, shoulders relaxed, ears over shoulders |
| 🚶 Stand & move | every 60 min | Stand up and walk 2–3 minutes |
| 🤸 Stretch | every 90 min | Neck, shoulders, wrists, lower back |
| 🌙 Deep eye rest | every 120 min | Close eyes 30 s / use drops *(off by default)* |
| 🫁 Breathe | every 60 min | 5 slow deep breaths *(off by default)* |

## Features

- **Polished UI** with a calm wellness design system and **light / dark / system themes**
  (instant, flash-free theme switching).
- **Color-coded toolbar icon** (no badge text): **full-color teal** when running,
  **amber** when paused, **gray** when off or idle outside active hours — with a matching tooltip.
- **Live countdowns for every active reminder** — each row shows its remaining `mm:ss`
  and a depleting progress bar, turning amber in the final 60 seconds. A big **hero ring**
  highlights the soonest break.
- **Calming eye-break overlay** with a **guided breathing orb** (4s in / 4s out) and an
  animated 20-second countdown ring.
- **Configurable** intervals and on/off per reminder (1–240 min).
- **System notifications** with **Done** and **Snooze** buttons.
- **Active-hours mode** — only remind during your work hours (e.g. 09:00–18:00).
- **Pause for 1 hour** and a **master on/off** switch from the popup.
- **Soft chime** (optional) played via an offscreen document.
- **Insights**: per-reminder counts for today + a 7-day bar chart with weekly totals.
- **Accessible**: keyboard focus rings, ARIA labels, and `prefers-reduced-motion` support.
- Settings sync across your Chrome profile (`chrome.storage.sync`).

## Install (load unpacked)

1. Open `chrome://extensions`.
2. Enable **Developer mode** (top-right).
3. Click **Load unpacked** and select this `health-protect/` folder.
4. Pin the icon and open the popup. Done ✓

> Reminders use `chrome.alarms`, so they keep running even when the popup is closed.
> The lowest possible interval is 1 minute (Chrome's alarm minimum).

## Project structure

```
manifest.json          MV3 manifest
background.js           Service worker: alarms, notifications, sound, overlay dispatch
lib/config.js           Shared reminder catalogue + settings/stats/theme helpers (all contexts)
lib/theme.css           Design-system tokens (light/dark) + shared UI primitives
content/                In-page full-screen break overlay (JS + CSS)
offscreen/              Offscreen doc that plays the chime (Web Audio, no audio file)
popup/                  Toolbar popup UI
options/                Full settings + history page
icons/                  Generated PNG icons (+ make_icons.py generator)
```

## Privacy

100% local. No accounts, no servers, no tracking, no network requests.
The `<all_urls>` content-script permission is used **only** to draw the eye-break
overlay on the page you're viewing.

## Regenerate icons

```bash
python3 icons/make_icons.py   # requires Pillow
```

health-protect-extension

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README