[varia]

📚 Reading Tracker
Reading Tracker is a flexible Calibre plugin designed to help you track, analyze, and visualize your reading activity.
Monitor progress, review statistics, and stay motivated with clear dashboards, KPIs, charts, and yearly summaries — all directly inside Calibre.

🚀 Key Features
📊 Interactive Dashboard

• Multi-year tracking
• Visualize reading trends with pie charts and monthly bar charts
• View total pages read and reading progress
• See most-read authors and genres
• Set and monitor yearly reading goals

🗂 Tracker Tab (Spreadsheet View)

• Edit reading data directly inside the plugin
• Supports:

◦ Tracked status
◦ Reading status (Finished, Reading, TBR, Paused, DNF)
◦ Start and finish dates
◦ Page count
◦ Format type (audio, ebook, print)
◦ Percentage read
◦ Ratings (supports half-star ratings)
◦ Optional review notes

• Alternating row styling adapts to plugin light/dark theme
• Automatically loads tracked books for quick editing

🧩 Guided Column Setup

• Dedicated Column Requirements panel
• Copy lookup names with one click
• Live mapping indicators (Required / Optional)
• Takes the pain out of custom column setup

🎨 Light & Dark Mode Support

• Fully theme-aware interface
• Instant switching between light and dark modes
• Consistent styling across all tabs

⚡ Performance Optimized

• Efficient handling of large libraries
• Fast loading of tracked books
• Optimized statistics calculations

🛠 Custom Column Requirements
Reading Tracker works with Calibre custom columns.
The plugin provides clear guidance to help you create and map:

• Yes/No tracking column
• Status (Tag Browser text)
• Start & Finish dates
• Page count
• Type (Tag Browser text)
• Percentage read
• Rating (Stars, half-star enabled)
• Optional review column

The setup process is guided and beginner-friendly.


📈 Designed For

• Readers tracking yearly reading goals
• Users who log detailed reading progress
• Those who want analytics without leaving Calibre
• Anyone who prefers structured reading statistics

🔢 Versioning
Version: 1.1.1
Type: Minor update (Stability & Sorting Update)

Spoiler:

📦 Reading Tracker v1.1.1
✨ Stability & Sorting Update

This update focuses on fixing table sorting, rating consistency, and overall stability improvements across the Tracker and Dashboard.

🛠️ Stability & Sorting Improvements

• Fixed Tracker table sorting for dates, numeric columns, and ratings
• Pages and Percentage columns now sort numerically (not by first digit)
• Start and Finish dates now sort chronologically
• Title column sorting restored to proper alphabetical order

⭐ Rating System Fixes

• Corrected half-star display inconsistencies
• Resolved rating scale conversion (Calibre 0–10 → 0–5 display)
• Half-star ratings now fully supported across Tracker and Dashboard
• Improved consistency between Tracker, Dashboard, and Calibre

📊 Dashboard Accuracy Improvements

• Rating statistics now correctly reflect stored Calibre values
• Improved data stability during refresh and filtering

🔧 Internal Refinements

• Improved table refresh stability
• Cleaner handling of numeric and date fields
• General polish and internal cleanup

Spoiler:

📦 Reading Tracker v1.1.0
✨ What’s New
🧩 Improved Columns Setup

• New Column Requirements panel
• Two-column layout for better readability
• Copy Lookup buttons for quick column creation
• Live mapping indicators (✅ Mapped / ❌ Missing)
• Setup workflow is significantly clearer and faster

📊 Tracker Tab Enhancements

• Tracker table now loads automatically on open
• Alternating row colors now fully follow plugin light/dark theme
• Improved table readability and consistency

📈 Dashboard Improvements

• Fixed rating calculation errors
• Added proper support for half-star ratings (e.g., 0.5, 1.5, etc.)
• Improved statistics reliability and stability

🎨 Theme Consistency

• Full light/dark mode alignment across:

◦ Dashboard
◦ Tracker tab
◦ Columns tab

• Table styling now independent of Calibre theme
• Instant live theme switching

🛠 Bug Fixes

• Fixed column mappings appearing to reset after Preferences changes
• Fixed dashboard population errors
• Resolved NameError and KeyError issues in stats engine
• Improved performance for large libraries

Caveats:

Spoiler:

The plugin was made using LLM, with my input and direction. I am not a programmer. You are advised to follow good backup procedure. Check plugins on a test copy of Calibre. If the code does not follow proper standards, I would like to know specifics. This plugin is not meant to 'compete' with any others, only to provide tracking for readers.

Thanks for the feedback.
Varia

[P.S. A big thank-you to Comfy.n for the encouragement and tech assistance]