Chunked Progress Bar

An Anki add-on that splits your review session into fixed-size chunks and shows your progress on two linked bars while you review:

• Chunk bar — one tile per chunk (e.g. per 10 cards). Completed chunks are coloured by how well you answered the cards inside them, the chunk you are in is highlighted, and upcoming chunks stay dimmed.
• Card bar — a zoomed-in view of the current chunk, one tile per card, coloured by the answer you gave (Again / Hard / Good / Easy).

Reviewing a big backlog feels much lighter when it's "3 chunks left" instead of "137 cards left".

Features

Chunk evaluation

When a chunk is completed, the add-on averages the answers inside it (each of Again / Hard / Good / Easy has a configurable weight) and colours the tile based on which interval the average falls into. Intervals are fully editable: boundaries, open/closed brackets, and which ones are enabled. Borderline intervals use a striped two-colour pattern.

FSRS integration

Instead of tuning intervals by hand, you can generate them from a desired retention value: chunks that meet your retention target are coloured as passing, chunks below it as failing. Optionally the add-on can:

• recalculate the intervals automatically when you change the chunk size, and
• fetch the desired retention of the deck you select (averaged over its subdecks) and adapt the colouring to it.

Perfect chunks

Chunks where every card was answered with a passing grade can be highlighted with diagonal stripes in a special colour, laid over the chunk's normal colour. You can choose whether Hard counts as perfect or whether only Good/Easy do.

Session tracking

• Progress is rebuilt from today's review log when you enter the reviewer, so it survives restarts, deck switches and syncs.
• Filtered subdecks work when reviewing through their parent: completed cards stay counted after returning home, and each filtered deck keeps its own review history. Bury, suspend, delete and undo also carry across parent/subdeck views.
• Failed cards can either be acknowledged (the bar grows to include the extra reviews, with the excess highlighted) or ignored.
• Burying, suspending and deleting are detected — including from the menus — each with its own colour and an acknowledge/ignore policy.
• Redo re-adds the review to the bar, and undoing a non-review action (e.g. changing preferences) leaves the bar untouched.
• Undo can either roll the bar back or mark the undone answer in its own colour.
• New cards can optionally be counted twice, matching decks where a new card comes back once more the same day.

Text, numbers and timers

Each bar can independently show:

• a number or percentage on every tile (counting done or remaining, chunk-wise or card-wise, absolute or relative to the chunk),
• a large centred number or percentage for the whole bar (e.g. 374/1327 or 62.50%),
• per-chunk and per-card timers, including a live timer for the current card/chunk.

Every text element has its own colour, bold and outline settings. Text can hide itself automatically when tiles get too small, and the centred text gets out of the way while you hover over the bars so you can read the tile labels underneath.

Layout

Each bar can be placed at the top or bottom of the main window (or hidden), in any stacking order. Bars are only visible while reviewing and disappear when you return to the deck list or leave the reviewer. All colours are customisable, including the ones for buried, suspended and undone cards.

Settings

Open Tools → Progress Bar Settings, or simply double-click either bar. All changes preview live while you review.

Installation

In Anki, go to Tools → Add-ons → Get Add-ons…, paste this code and restart Anki:

1724662218

You can also find it on AnkiWeb.

Updating

Use Tools → Add-ons → Check for Updates, accept the update, and restart Anki. Updates to this existing listing preserve your configuration and local session data.

Local .ankiaddon packages use the same ID (1724662218) so they replace the existing add-on too. The older chunked_progress_bar package is marked as conflicting and is disabled if present, preventing duplicate bars.

Building and publishing

Run python tools/build_addon.py /path/to/chunked-progress-bar.ankiaddon, then upload that file as an update to the existing AnkiWeb listing 1724662218. AnkiWeb supplies the release timestamp; keep the same listing so existing users receive the update through Anki's update checker.

The build includes only code, default configuration, the manifest and the user_files readme. It excludes meta.json, saved session data, tests and Python caches.