Jun 8, 2026

description

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.5.0 — 2026-05-15

### New
- **Comprehension Progress section** — A new dashboard section (between Top Videos and Video History) that surfaces content you rewatched *and* understood better over time. An entry appears only when it was logged 2+ times with a comprehension score and the score rose (latest higher than first). Sources are mixed: YouTube videos, manual entries, and sessions. Sorted by improvement, then by efficiency (same gain in less time ranks higher). Each row shows the time span from first to last scored viewing, total time, replay count, and a `40 % → 80 % +40` improvement chip — and expands to the individual viewings.

### New
- **Comprehension prompt timing** — You can now choose *when* the YouTube comprehension prompt appears: **midway** through a video (after half your real watch time, capped at 10 minutes — the video pauses for the prompt and resumes after you save) or **at the end**. Set it in the reworked "Comprehension prompt" settings card, which now also holds the manual-entry ask frequency in one place.

### Changed
- **Default settings** — Comprehension tracking is now on by default; the popup opens on the Stats tab.
- **Daily-goal threshold dots** — The five dots now sit at even steps (20 / 40 / 60 / 80 / 100 % of the daily goal). Beat your goal by 10 % or more and the whole row quietly starts to glow, with a line showing how far over you are — a small hidden reward for going past the goal.
- **Comprehension auto-prompt position** — The "how much did you understand?" prompt now appears as a card centered over the video player with a dimmed backdrop, instead of a banner at the bottom edge of the page. It is injected into the player container, so it is also visible in theater and fullscreen mode. The 60-second auto-dismiss was removed — it stays until you answer or skip.
- **Auto-prompt trigger simplified** — The prompt now appears only when a video finishes, not when you switch away from the tab. The tab-switch trigger built the prompt while the tab was hidden, so it was invisible exactly when it mattered and intrusive when you returned to keep watching. For videos you do not finish, log comprehension manually via the action-bar button.

---

## v0.4.7 — 2026-05-15

### Fixed
- **YouTube button sometimes missing** — The action-bar button now uses a polling loop (up to 10s) plus the native `yt-navigate-finish` event, so it appears reliably even when YouTube renders the page slowly or swaps the action bar (theater mode, layout changes).
- **Pill row shifting on narrow windows** — When the browser window was narrow, the IMMERWAY button used to push the native YouTube pills (Like, Share, Save) out of the row until a resize fixed the layout. The button now shrinks along with the row.

### Changed
- **Button icon: eye → IMMERWAY logo** — The action-bar button now shows the IMMERWAY brand symbol (three concentric rings + center dot) instead of a generic eye icon. Clearer affiliation at a glance.
- **Current viewing marked "(jetzt)"** — In the dropdown's viewing list, the currently running session is now labeled with `(jetzt)` next to its duration, in addition to the subtle background highlight.

### Fixed
- **YouTube dropdown wouldn't close on outside click** — Once you clicked anything inside the dropdown (slider, number field), clicking outside it no longer closed it. Now a click anywhere outside reliably closes it.

### Fixed (continued)
- **Name autocomplete** — Reworked to address-bar-style inline completion: the suggested rest of the name is shown highlighted inside the field itself, instead of a separate ghost overlay that never aligned correctly. Tab accepts, typing overrides, Escape dismisses. Now works consistently in all three name fields (dashboard manual entry, popup manual tab, popup session label) — the popup manual tab had no autocomplete at all before.

---

## v0.4.6 — 2026-05-14

### Fixed
- **Live tracking in YouTube UI** — The eye button now shows correct watch time in real time without requiring a page reload. Previously, the button showed "not watched yet" for the current session until the page was reloaded.
- **Comprehension not saved to individual viewings** — Comprehension scores are now correctly stored per viewing. Previously, the score appeared on the main video row but not on the individual sub-rows in Video History.
- **Comprehension lost when saved before first flush** — If comprehension was submitted before the first data batch was written to storage, the score was silently dropped. Now the viewing entry is created on the spot if it doesn't exist yet.

### Improved
- **Immerway Light theme** — Refined colors across borders, hover states, accent, and status colors for better contrast and visual clarity.
- **Semantic color variables** — Heatmap, threshold dots, and streak tile now use dedicated CSS variables (`--accent-data`, `--accent-streak`) instead of sharing `--accent`. Themes can now style these independently.

### Changed
- **Extension description** — Updated to better reflect what the extension does: time tracking, comprehension tracking, and progress measurement.

---

## v0.4.5 — 2026-05-13

### New
- **Feedback link** — Footer now has a "Feedback" link that opens a pre-filled email to [email protected]. 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 [email protected] 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.

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.

Comprehension Tracking
After saving a session: "How much did you understand?" Set 0–100% on a visual bar, or skip.

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.

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, stages, 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.7.0 — 2026-05-30

The biggest release so far — a full rebrand and redesign. The extension is now
**Arthur**, the popup becomes a persistent side panel, the dashboard is rebuilt
from the ground up, and challenges, keyboard shortcuts and a passive mode arrive.

### New
- **Meet Arthur** — The extension is now named *Arthur · Immersion Tracker*, with a refreshed identity.
- **Side panel replaces the popup** — Clicking the toolbar icon opens a persistent side panel (Session · Manual · Stats) that stays visible next to YouTube. A stopwatch for offline immersion (books, audio, TV), manual entries, and your live stats — all in one place. Smooth transitions, inline title autocomplete, full-screen save confirmation.
- **Rebuilt dashboard** — A completely new dashboard: today/week/month tiles with apple-to-apple comparisons, a stacked monthly bar chart with a 7-day trend line, channel donuts (all-time + last 7 days), a comprehension distribution band, a comprehension-progress section, records, and a 4-week heatmap.
- **Challenges with stages** — Set an hour goal with a deadline and split it into stages (equal, rising, falling, or custom distribution). Dashboard and side panel show overall progress plus stage transitions on the bar.
- **Action buttons in the header** — Manual entry, Search, Settings, and a light/dark toggle now sit as compact icon buttons at the top of the dashboard, instead of being mixed into the body.
- **Keyboard shortcuts** — `Alt+Shift+A` (Mac: `Option+Shift+A`) opens/closes the side panel, `Alt+Shift+D` opens the dashboard. A for Arthur, D for Dashboard. View and rebind them in Settings → Display.
- **Passive mode for other accounts** — Switch to a YouTube account that isn't your tracked one and the Arthur button greys out, the comprehension prompt is disabled — a clear signal that nothing is tracked or recorded. The YouTube page itself stays untouched.
- **"Since immersion start" tile** — Days since you began, average per day, and your start date.
- **Bring your history in (guided onboarding)** — A step-by-step setup, plus an optional AI import so you don't start from zero: copy a prompt, run it in any AI chat (ChatGPT, Claude, Gemini), describe or paste your past immersion (a spreadsheet, notes, or just estimates), and paste the result back. The tracker fills in the daily detail itself — real logs stay exact, estimates are clearly marked.

### Changed
- **Coherent comparison logic** — "This week" and "this month" compare the same way in the dashboard and the side panel (average per elapsed day vs. last week's / last month's average).
- **Smarter streaks** — A day counts toward your streak once you reach 20 % of your daily goal *today*. Past days you already earned stay earned, even if you later raise your goal — your streak is history, not recalculated. Today counts forward as long as yesterday was active, with a "X min until streak locked" hint.
- **Today, reimagined** — Instead of a "vs. yesterday at this time" comparison, the Today tile now shows how much is left to your daily goal ("X to go" → "Goal reached ✓" → "+X over goal") — a forward nudge, not a comparison.
- **Live-ticking dashboard** — Today / This week / This month and the top cards now tick up while you watch, instead of freezing until reload. Charts stay put; only the numbers move.
- **Richer hovers** — A unified hover format across dashboard and side panel: each tile shows the average per day, comparison, active days, your top day, and average comprehension. Bilingual DE/EN.
- **Active challenge precision** — Percentage shows two decimals, hours one decimal — no rounding to flat numbers.
- **Consistent chart colors** — Bar chart, both donut sections, and legends now share one theme-aware palette, with softened opacity.
- **Local fonts** — Fonts are now bundled, so the dashboard opens instantly, works offline, and makes no external request.

### Fixed
- **Passive mode** — On a non-tracked YouTube account the Arthur button now correctly greys out and the live dot stops pulsing (it previously kept pulsing as if tracking).
- **Active challenge "required per day"** in the side panel now matches the dashboard (it was computed against the stage instead of the whole challenge).
- Tooltip width clipping long text; action-button tooltips after a click; comprehension-progress double divider line; heatmap hover sizing; calendar/date-picker icons now match the theme; challenge slope marker updates instantly.

## v0.5.0 — 2026-05-15

### New
- **Comprehension Progress section** — A new dashboard section (between Top Videos and Video History) that surfaces content you rewatched *and* understood better over time. An entry appears only when it was logged 2+ times with a comprehension score and the score rose (latest higher than first). Sources are mixed: YouTube videos, manual entries, and sessions. Sorted by improvement, then by efficiency (same gain in less time ranks higher). Each row shows the time span from first to last scored viewing, total time, replay count, and a `40 % → 80 % +40` improvement chip — and expands to the individual viewings.

### New
- **Comprehension prompt timing** — You can now choose *when* the YouTube comprehension prompt appears: **midway** through a video (after half your real watch time, capped at 10 minutes — the video pauses for the prompt and resumes after you save) or **at the end**. Set it in the reworked "Comprehension prompt" settings card, which now also holds the manual-entry ask frequency in one place.

### Changed
- **Default settings** — Comprehension tracking is now on by default; the popup opens on the Stats tab.
- **Daily-goal threshold dots** — The five dots now sit at even steps (20 / 40 / 60 / 80 / 100 % of the daily goal). Beat your goal by 10 % or more and the whole row quietly starts to glow, with a line showing how far over you are — a small hidden reward for going past the goal.
- **Comprehension auto-prompt position** — The "how much did you understand?" prompt now appears as a card centered over the video player with a dimmed backdrop, instead of a banner at the bottom edge of the page. It is injected into the player container, so it is also visible in theater and fullscreen mode. The 60-second auto-dismiss was removed — it stays until you answer or skip.
- **Auto-prompt trigger simplified** — The prompt now appears only when a video finishes, not when you switch away from the tab. The tab-switch trigger built the prompt while the tab was hidden, so it was invisible exactly when it mattered and intrusive when you returned to keep watching. For videos you do not finish, log comprehension manually via the action-bar button.

---

## v0.4.7 — 2026-05-15

### Fixed
- **YouTube button sometimes missing** — The action-bar button now uses a polling loop (up to 10s) plus the native `yt-navigate-finish` event, so it appears reliably even when YouTube renders the page slowly or swaps the action bar (theater mode, layout changes).
- **Pill row shifting on narrow windows** — When the browser window was narrow, the IMMERWAY button used to push the native YouTube pills (Like, Share, Save) out of the row until a resize fixed the layout. The button now shrinks along with the row.

### Changed
- **Button icon: eye → IMMERWAY logo** — The action-bar button now shows the IMMERWAY brand symbol (three concentric rings + center dot) instead of a generic eye icon. Clearer affiliation at a glance.
- **Current viewing marked "(jetzt)"** — In the dropdown's viewing list, the currently running session is now labeled with `(jetzt)` next to its duration, in addition to the subtle background highlight.

### Fixed
- **YouTube dropdown wouldn't close on outside click** — Once you clicked anything inside the dropdown (slider, number field), clicking outside it no longer closed it. Now a click anywhere outside reliably closes it.

### Fixed (continued)
- **Name autocomplete** — Reworked to address-bar-style inline completion: the suggested rest of the name is shown highlighted inside the field itself, instead of a separate ghost overlay that never aligned correctly. Tab accepts, typing overrides, Escape dismisses. Now works consistently in all three name fields (dashboard manual entry, popup manual tab, popup session label) — the popup manual tab had no autocomplete at all before.

---

## v0.4.6 — 2026-05-14

### Fixed
- **Live tracking in YouTube UI** — The eye button now shows correct watch time in real time without requiring a page reload. Previously, the button showed "not watched yet" for the current session until the page was reloaded.
- **Comprehension not saved to individual viewings** — Comprehension scores are now correctly stored per viewing. Previously, the score appeared on the main video row but not on the individual sub-rows in Video History.
- **Comprehension lost when saved before first flush** — If comprehension was submitted before the first data batch was written to storage, the score was silently dropped. Now the viewing entry is created on the spot if it doesn't exist yet.

### Improved
- **Immerway Light theme** — Refined colors across borders, hover states, accent, and status colors for better contrast and visual clarity.
- **Semantic color variables** — Heatmap, threshold dots, and streak tile now use dedicated CSS variables (`--accent-data`, `--accent-streak`) instead of sharing `--accent`. Themes can now style these independently.

### Changed
- **Extension description** — Updated to better reflect what the extension does: time tracking, comprehension tracking, and progress measurement.

---

## v0.4.5 — 2026-05-13

### New
- **Feedback link** — Footer now has a "Feedback" link that opens a pre-filled email to [email protected]. 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 [email protected] 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.

Jun 8, 2026

short_description

Track your language immersion time across YouTube and other sources, and measure your progress through comprehension tracking.

Arthur — Immersion and Comprehension Tracker. Two measures of progress: hours and comprehension.

Jun 8, 2026

name

Immersion Tracker

Arthur · Immersion Tracker

Jun 8, 2026

permissions

storage, tabs, scripting

storage, unlimitedStorage, tabs, scripting, sidePanel

May 20, 2026