Reading Progress¶

Track what you've read, what you're reading, and what's next — across your whole family library.

Reading Statuses¶

Every book copy has one of three statuses:

stateDiagram-v2
    direction LR
    state "🔵 Want to Read" as WTR
    state "🟡 Reading" as R
    state "🟢 Finished" as F

    [*] --> WTR : Added to library
    WTR --> R : Start reading
    R --> F : Finish the book
    F --> R : Re-read
    WTR --> F : Mark as already read
    R --> WTR : Abandon / pause

Status	Badge colour	Description
Want to Read	🔵 Blue	On your to-read list
Reading	🟡 Yellow	Currently in progress
Finished	🟢 Green	Completed (at least once)

Updating Reading Status¶

From the book detail page¶

Open a book
Click the coloured status badge
Select the new status from the dropdown
The change is saved immediately

From the book list¶

Hover over a book card
Click the status badge on the card
Select the new status

Your Reading List¶

To see all books in your to-read pile:

Click Library in the sidebar
Click the Want to Read filter (or use the sidebar shortcut)

Books are sorted by date added by default — oldest first, so you tackle the pile in the order you built it.

Books Currently Reading¶

Click Library → Reading filter

You can have multiple books with "Reading" status at once — useful when you're reading different books in different rooms.

Reading History¶

All status changes are recorded in the audit log on each book's detail page.

What's recorded	Example
Status changed to Reading	2026-03-01 · Carmelo started reading
Status changed to Finished	2026-03-15 · Carmelo finished
Status changed back to Reading	2026-09-01 · Carmelo re-reading

This gives you a complete timeline for each book.

Library Statistics¶

The Stats page (accessible from the sidebar) shows:

pie title My Library (example)
    "Want to read" : 45
    "Reading" : 3
    "Finished" : 128

Stat	Description
Total books	All owned copies in the family library
Want to read	Your to-read pile
Reading	Books in progress
Finished	Completed books
Books this year	Books marked "finished" in the current calendar year
Average per month	Finished books / months since account created

Family vs personal stats

Stats are currently family-wide — they aggregate all copies across all family members. Personal per-user stats may be added in a future release.

Tips for Tracking Progress¶

Daily reading habitRe-reading a bookBooks you read before joining JinbochoManaging a big to-read pile

Mark a book as Reading when you start it. When you finish, change it to Finished. The audit log records the dates automatically — you get a reading duration without any extra steps.

Books you've already finished can go back to Reading for a re-read. The audit log shows each reading cycle separately.

Add the book and immediately set the status to Finished. The date will show as your join date, not the original reading date — but the book will correctly appear in your finished collection.

If your Want to Read list is overwhelming, use the position field creatively: assign your most-anticipated next reads to the top shelf of a dedicated "To Read" bookcase so they're always physically within reach.