AnkiWeb
- Rating
- 0 (👍 0 · 👎 0)
- Updated
- 2026-09-13
- Anki versions
- 26.08.1~
- Description language
- en
Fatigue Alert
AnkiWeb addon 1071808091
Monitors review speed and error rates against your baseline, then displays non-intrusive floating break alerts with adaptive calibration, cooldowns, and 17+ language support.
Open on AnkiWeb GitHub Ask about alternatives
Maintenance
active
- Last update or commit was 18 days before the snapshot (2026-09-13).
GitHub
- Repository
- ficello/anki-fatigue-alert · more by ficello
- Stars
- ⭐ 0 · forks 0 · open issues 0
- Last commit
- 2026-09-13
- License
- CC0-1.0
- Languages
- Python
- Tests
- 0
Will it work on my Anki?
Version branches
| Min Anki | Max Anki | Updated |
|---|---|---|
| 2.1.1 | 26.08.1+ | 2026-09-13 |
History across monthly snapshots
Loading…
Similar addons
Detects attention drift or fatigue via answer-rhythm variability, prompting brief micro-movements or real breaks, with dashboard insights and fully local privacy.
Tracks review speed in the background with a navbar focus timer, detects drift over the last eight cards, alerts gently, and silences alerts for three minutes.
Estimates daily Anki review time, adjusts for fatigue and retention, splits sessions into spaced blocks, simulates faster speeds, and lets users include or exclude decks.
Alerts users with optional sound and pop-up when they review cards too quickly, showing time spent and advice to slow down, with configurable ease thresholds, mute option, and messages.
Predicts Anki study time, finish time, pacing, retention, fatigue, and distractions using offline machine learning, customizable progress metrics, and fully adjustable UI styling.
Displays configurable periodic and inactivity reminders with popups offering Study Now or Later, helping Anki users stay focused during and outside reviews.
README
🧠 Fatigue Alert for Anki (Alerte Fatigue)
Fatigue Alert is an intelligent, non-intrusive Anki add-on designed to detect cognitive fatigue and declining review efficiency in real time. It monitors your response speed and error rates against your personal baseline, gently advising you when it is time to take a break.
📸 Overview & Screenshots
<div align="center"> <img src="docs/images/alert_dark_light.png" alt="Fatigue Alert Popup" width="700"> </div>
✨ Features
- ⚡ Real-Time Fatigue Detection:
- Compares your current pace (sliding window) against your historical baseline (
revlogor early-session reference). - Triggers an alert if you experience a sharp slowdown (e.g. 1.8× baseline) or a sudden spike in failed reviews (e.g. 60%+ errors).
- Compares your current pace (sliding window) against your historical baseline (
- 🎯 Non-Intrusive & Floating Alert:
- Displays a clean floating alert in the top-right corner without blocking keyboard shortcuts or interrupting your study flow.
- 🧬 Self-Calibrating & Adaptive:
- "Yes — Take a Break": Confirms fatigue and pauses the session.
- "Fatigued, but Continuing": Confirms fatigue while letting you keep reviewing.
- "Algorithm is Wrong": Dynamically lowers sensitivity to prevent false positives.
- "Report: Stopped Due to Fatigue": Explicitly log a fatigue stop from the Tools menu to adapt thresholds per deck.
- 🛡️ Anti-Spam & Cooldown:
- Minimum delays (e.g. 15 minutes / 20 cards) between alerts.
- Pause tolerance (e.g. 2 min) keeps your session alive if you briefly step away.
- 🎨 Native Light & Dark Themes:
- Automatically matches Anki's Night Mode and UI styling.
- 🌍 Full Multilingual Support (i18n):
- 17+ languages fully translated and automatically detected from Anki preferences.
🚀 Installation
Via AnkiWeb (Recommended)
- In Anki, go to Tools > Add-ons > Get Add-ons...
- Enter the Add-on Code:
1071808091 - Restart Anki.
Manual Installation (.ankiaddon / Source)
- Download the
.ankiaddonfile from the Releases tab or clone this repository. - In Anki, open Tools > Add-ons > Install from file... and select
Anki_EDN_Fatigue_Alert.ankiaddon. - Alternatively, copy the
Anki_EDN_Fatigue_Alertfolder directly into your Ankiaddons21/directory.
⚙️ Configuration & Usage
Access options directly through:
- Tools > Fatigue Alert > Settings...
- Tools > Fatigue Alert > Enable Fatigue Detection (quick toggle checkable directly in menu)
- Tools > Fatigue Alert > Report: Stopped Due to Fatigue
Config Parameters (config.json)
| Parameter | Default | Description |
|---|---|---|
enabled |
true |
Enable or disable fatigue detection. |
window_size |
5 |
Number of recent cards analyzed in the sliding window. |
baseline_cards |
10 |
Initial session cards used as baseline if no history is present. |
min_cards_before_alert |
19 |
Minimum number of cards before allowing the first alert. |
time_ratio_threshold |
1.8 |
Slowdown ratio triggering an alert (1.8× = 80% slower than baseline). |
error_rate_threshold |
0.6 |
Error rate ratio triggering an alert (0.6 = 60% failures in window). |
cooldown_minutes |
15 |
Minimum cooldown in minutes between two consecutive alerts. |
cooldown_cards |
20 |
Minimum cards reviewed between two consecutive alerts. |
pause_tolerance_minutes |
2 |
Time window within which resuming reviews continues the same session. |
use_revlog_baseline |
true |
Analyze Anki's past revlog review history for baseline pace. |
revlog_baseline_days |
30 |
Number of past days analyzed for the revlog baseline. |
🛠️ Project Structure
Anki-Fatigue-Alert/
├── __init__.py # Hook registrations & menu setup
├── alert_dialog.py # Custom floating fatigue alert UI
├── analyzer.py # Real-time pacing & error rate analysis engine
├── config.py # Configuration getter, setter and defaults
├── config.json # Default user configurations
├── deck_utils.py # Deck resolution utilities
├── feedback_store.py # SQLite persistence for feedback & adaptive thresholds
├── i18n.py # Internationalization dictionary & locale detection
├── logger.py # Add-on logging utility
├── manifest.json # Anki add-on manifest metadata
├── settings_dialog.py # Clean Qt settings dialog
├── docs/ # Documentation assets & screenshots
├── LICENSE # MIT License
└── README.md # Repository documentation
📄 License
This project is licensed under the MIT License.