FocusFlow

FocusFlow is a comprehensive study companion for Anki that combines a focus timer, interactive study history, fatigue tracking, goal tracking, and long-term learning analytics into a single, integrated dashboard.

FocusFlow keeps a long-term record of your study activity, allowing you to revisit your learning history even as your collection changes over time.

Quick Start

1. Open the FocusFlow panel.
2. Start a study session using the built-in focus timer.
3. Explore your study history by clicking days, weeks, or months in the heatmap.
4. Open Settings to customize FocusFlow to your own workflow.

Features

Permanent Study History

FocusFlow keeps a permanent record of your study activity, making it easy to look back at your learning progress even after cards, notes, or entire decks have changed or been removed.

Focus Timer

Stay focused with an integrated Pomodoro-style timer.

Features include:

• Custom study and break durations
• Automatic pause when reviewing stops
• Optional adaptive session lengths
• Session goals and end conditions
• Custom notification sounds

Fatigue Detection

FocusFlow monitors your study behaviour throughout each session and can suggest a break before fatigue begins to affect your performance.

Fatigue can be detected using:

• Response speed
• Timing consistency
• Answer quality

Sensitivity and monitored signals are fully configurable.

Interactive Heatmap

Visualize your learning with a GitHub-style contribution calendar.

Features include:

• Multiple colour themes
• Review Count, Effective Time, or Study Quality metrics
• Daily, weekly, monthly, and yearly summaries
• Due-card forecasting
• Click any day to inspect detailed statistics
• Built-in notes and reminders
• Current and longest streak tracking

Study Analytics

Gain insight into your study habits with statistics such as:

• Study Quality
• Effective Study Time
• Review Time
• New Cards
• Review Cards
• Streaks
• Session Summaries

Goals

Track your progress using customizable study goals.

Depending on your settings, FocusFlow can display:

• Goal completion
• Remaining cards
• Estimated time remaining

Customization

FocusFlow is designed to be highly customizable.

Customize nearly every aspect of the add-on, including:

• Heatmap appearance
• Colour schemes
• Timer behaviour
• Fatigue detection
• Toolbar layout
• Statistics display
• Notification sounds
• Multiple configuration profiles

Why FocusFlow?

FocusFlow brings together several study tools into one place, making it easier to understand not only how much you study, but also how you study.

Instead of switching between multiple add-ons, FocusFlow combines focus sessions, study analytics, goals, reminders, fatigue tracking, and long-term study history in a single interface designed to feel like a natural extension of Anki.

If you're looking for a dedicated heatmap, Review Heatmap is an excellent community add-on. Likewise, if you only need a lightweight Pomodoro timer, Minimalist Pomodoro is another great option.

FocusFlow takes a different approach by bringing these ideas together with long-term analytics, fatigue tracking, goals, reminders, and permanent study history in one integrated workflow.

Configuration

All settings are available from:

Tools → Add-ons → FocusFlow → Config

or from the built-in Settings dialog.

Settings are organized into the following categories:

• Timer
• Fatigue
• Heatmap
• Display
• Toolbar & Sound
• Measurement

Most settings include tooltips explaining what they do.

Compatibility

Supported on:

• Developed and tested with Anki 26.08.1
• PyQt6
• Windows
• macOS
• Linux

Please refer to the project page for the latest compatibility information.

Feedback

Suggestions, feature ideas, and bug reports are always welcome.

User feedback has played a big role in shaping FocusFlow, and every suggestion helps improve it for everyone.

GitHub Issues:

https://github.com/Doummar/FocusFlow/issues

License

Released under the MIT License.

See the LICENSE file for the full license text.

Happy studying!

— Adel