Immersion Tracker

Immersion Tracker counts every minute you spend with your target language, automatically and manually.

Automatic YouTube Tracking
The extension tracks your YouTube watch time in the background. Set your YouTube handle once, and it counts every video you watch on that profile. Switch accounts freely, only your configured profile is tracked. Shorts can be excluded.

Session Timer
Start a focused session in one click from the toolbar icon. The timer runs in the background, no tab needs to stay open. When you stop, pick a category and optionally add a label (show title, episode, book).

Manual Entry
Add immersion time in 3 clicks: pick +10, +30, or +60 minutes, select a category, hit Add. Available in the popup and as a permanent form in the dashboard. Counts toward your daily total and all active challenges.

Comprehension Tracking (optional)
After saving a session: "How much did you understand?" Set 0–100% on a visual bar, or skip. Off by default, enable in Settings.

Stats & Dashboard
Open the full dashboard for: period tiles (Today, This Week, This Month, Since Start), bar charts, a 30-day heatmap, streak tracker, daily steps, immersion sources breakdown, top channels, top videos, and full session and video history.

Challenges
Set a time-bound immersion goal (e.g. 1000 hours by Easter). The dashboard shows hours completed, hours remaining, days left, and hours/day needed.

Data
All data is stored locally in your browser. Export as TSV or JSON, import from backup, delete by video, channel, or time range.

# Immersion Tracker — Release Notes

---

## v0.4.5 — 2026-05-13

### New
- **Feedback link** — Footer now has a "Feedback" link that opens a pre-filled email to hi@immerway.com. Language-adaptive (EN/DE). Subject is always `[Immersion Tracker Feedback]` for easy filtering.

### Improved
- **Auto-prompt on short videos** — When a video ends completely, the comprehension prompt now always appears (as long as ≥ 30s were watched), even for videos shorter than 5 minutes. The 5-minute threshold only applies to tab switches.
- **Onboarding text** — Clarified that only the entered YouTube account is tracked. Switching to a different YouTube account pauses tracking automatically.

---

## v0.4.4 — 2026-05-13

### New
- **Video History: Viewing details** — Videos watched more than once show a ×N counter. Click the row to expand and see each individual session with date, time, duration, and comprehension score.
- **Search by channel** — Typing a channel name in the search modal now finds all videos from that channel.
- **Feedback link** — Footer now has a "Feedback" link that opens an email to hi@immerway.com with a pre-filled template and version number. Language-adaptive (EN/DE).

### Improved
- **Comprehension slider uses 10-step increments** — Values snap to 0, 10, 20 … 100 instead of a continuous scale. Both the dropdown and the auto-prompt are affected.
- **YouTube button spacing** — The eye button in the YouTube action bar now has correct spacing matching native YouTube buttons.
- **Auto-prompt on short videos** — When a video ends completely, the comprehension prompt now always appears (as long as ≥ 30s were watched), even if the video is shorter than the 5-minute threshold. The 5-minute threshold only applies to tab switches.

### Fixed
- Comprehension input section was missing from the dropdown when the video had previous viewings in storage but the current session hadn't crossed 30s yet.

---

## v0.4.3 — 2026-05-13

### New
- **Per-viewing tracking** — Every time you watch a video, it is recorded as a separate viewing session with its own timestamp, duration, and comprehension score. Previously, all watch time was merged into a single daily total.
- **Eye button in YouTube UI** — A pill button appears in the YouTube action bar showing how many times you've watched the current video (e.g. ×3). Updates in real time once 30 seconds are watched.
- **Comprehension dropdown** — Click the eye button to see your viewing history for that video and enter a comprehension score (slider + number, 0–100).
- **Auto-prompt on video end / tab switch** — When a video ends or you navigate away after watching for ≥ 5 minutes, a prompt appears asking for your comprehension score. Auto-dismisses after 60 seconds. "Skip" leaves no value saved.
- **Search shows individual viewings** — In the dashboard search modal, each viewing session appears as its own row with date, time, duration, and comprehension.

### Improved
- **30-second minimum** — Watch time under 30 seconds is not counted as a viewing. YouTube Shorts are exempt.
- **Replay detection** — Watching the same video again from the beginning (after watching > 30s) creates a new viewing entry automatically.

### Fixed
- Sort arrows in table headers were invisible (language switcher was overwriting the arrow HTML).
- Wrong channel names were being saved due to an overly broad CSS selector picking up sidebar channels.
- Search was showing 0-second artefact viewings from early v0.4.x builds.
- Old watch time stored only in `dailySeconds` (pre-v0.4.0) was not appearing in search — now shown as a per-day fallback row.

---

## v0.3.3 — 2026-05-13

### New
- **Global search** — Magnifying glass icon in the dashboard header opens a search modal. Search across all tracked YouTube videos (by title), manual entries, and sessions by name. Results show viewing count, total time, and comprehension trend.

---

## v0.3.2 — 2026-05-13

### New
- **Sortable table headers** — Click any column header in Video History or Sessions History to sort by that column. Active column is highlighted in gold. Sort applies to the full database, not just the visible rows.

### Fixed
- YouTube watch sessions counter was never incrementing.
- Wrong channel name being saved (selector was matching sidebar/recommended channels instead of the video owner).
- Once a wrong channel name was saved, it was never corrected. Now channel info is updated on every tick.

---

## v0.3.1 — 2026-05-13

### New
- **Ghost-text autocomplete** — When typing a name in the manual entry field (dashboard and popup), the best previous match appears as grey ghost text. Tab or → to accept.
- **Comprehension hint** — If comprehension tracking is on and the name is known, a hint shows the last recorded value ("Last time: 70 %"). After saving a higher value, a brief "+20 % — improvement!" confirmation appears.
- **Release script** — `release.sh` creates a versioned snapshot and ZIP in one command.

### Fixed
- Challenge tile was always showing 0 % progress and wrong type ("Streak" instead of "Challenge") due to mismatched field names.
- History toggle button in the dashboard manual entry form was causing layout jumps.

---

## v0.3.0 — 2026-05-07

### New
- **6 colour themes** — Navy Gold (default dark), Parchment (light warm), Mist (light cool), Ember (dark warm), Overcast (Sugimoto light grey), Deep Water (Sugimoto dark grey). Theme selector in Settings.