MobileRead Forums - View Single Post

thiago.eec · 08-22-2023, 09:56 AM

This plugin was created to help you manage your annual Reading Goal and keep a reading record over the years.

Main Actions:

Add to reading goal:
- Add the selected books to your current reading goal
- Books already in your reading goal will be ignored
- If you checked the option Allow adding other year's reading goal, you will be prompted to confirm the year (automatically fetched from selected books). Note that every book must have the same year to be added in batch.
Remove from reading goal:
- Remove the selected books from your reading goal
- Books that are not in your reading goal will be ignored
Edit reading goal:
- Here you can see all the books in your current reading goal
- Books are automatically organized in shelves (Want to read, Reading and Read), based on their reading progress
- Besides overseeing your reading goal, you can edit it:
  - Link to another book: you can change the calibre book linked to this entry. Useful in case you want to change the edition you are reading, or when the original book in your library was removed, leaving the entry orphaned
  - Remove from reading goal: remove the book from you reading goal, just like using the main menu option. No record is kept.
  - Mark the book as abandoned: differently from removing, the existing records are kept, and the last reading progress still counts for your goal statistics. Abandoned books will not be updated or moved to your next year's goal.
  - Show book's records: manage your reading records for this book. A new record is created every time you change your reading progress. You can delete past records, but not the current one.
    - Delete this record: if the book has more than one reading record, you will see this button for past records.
- Changes will be committed only when you hit Apply
Statistics:
- Here you have multiple graphics and statistics:
  - Readings by month
  - Readings by day
  - Readings by genre (top 12)
  - Annual readings
- You can also see the statistics for previous years, if they are present

Plugin options:

Custom columns: you must set the first three custom columns. Only columns of the right type will be available in the dropdown list.
- Reading progress: integers, floating point numbers or composite
- Status date: date
- Page count: integers
- Genre: text, composite. This column is not mandatory, but if you don't set it, then you will not have a 'Genre view'.
- You can create new custom columns, if you don't want to use the existing ones, by pressing the icon. Create all the columns you want before exiting the config dialog. You will be prompted to restart calibre.
Customize interface:
- Main button: choose which action will be performed when clicking the plugin icon on the toolbar
- Sort by: choose how books should be sorted on the Edit reading goal dialog
Auto add:
- Add to goal:
  - If you use other plugins that sync your reading activity, like Goodreads Sync or Skoob Sync, you might want to automatically add your books from a Want to read shelf. To accomplish this, you need to configure your sync plugin to use the same column selected here.
  - To trigger the auto add, this column just need to be set for the book, with any value. You can also check for a specific value, but only for some column types: bool, int, float or text. If the selected column is of one of those types, a value field will be available.
  - Notice that all values are converted to string before comparing.
- Add to challenges:
  - You can set a python dictionary to determine which columns/values will trigger the auto add. If the chosen column's value match, then the book will be added to the specified challenge. If the book is not in your goal, it will be added automatically.
  - Python dictionary model: {'challenge_name_1': {'#custom_column' : 'column_value'},'challenge_name_2': {'tags': 'some_tag'}
Auto backup:
- Set up an interval for automatic backups. If you leave it empty, no automatic backups will be made.
- You can also restore a backup file from the config dialog
Main options:
- Migrate unfinished books to the next year's goal: if you check this option, when a new year starts, all books on your Want to read and Reading shelves will be moved to your current year reading goal.
  - Your reading progress for the last year will not be taken into account when calculating your current year statistics
  - Abandoned books will not be moved
- Allow adding other year's reading goal: if you check this option, when adding books to your goal, you will be prompted to confirm the year (automatically fetched from selected books). Note that every book must have the same year to be added in batch.
- Use 'Rereading' shelf: If you check this option, books that you already read before, will be added to a Rereading shelf.
- Use a 'Rereading' color, instead of a shelf: Check this option to use a different color for rereadings.
- Use a rereading counter: Check this option to add a counter for how many times you've reread the book.
- Keep 'Rereading' color for finished books: If you check this option, it will retain the line color for books migrating from the 'Rereading' shelf to the 'Read' shelf.
- Jump to the selected book: If you check this option, when opening the 'Edit reading goal' dialog, it will jump to the selected book in your calibre library.
Display options:
- Auto collapse: List the shelves you want to be collapsed when opening the 'Edit reading goal' dialog. Use a comma separated list with the shelves numbers. Example: 1, 3, 5.
- Shelf colors: Set the color for each shelf on the 'Edit reading goal' dialog. Use a python dictionary with shelf number and RGB value. Example: {1: (180, 230, 255), 3: (250, 190, 80)}.

Database information:

The plugin does not modify your calibre library. Its database is kept in a JSON file saved to your calibre config directory (AppData\Roaming\calibre\plugins, for Windows).
Each calibre library has its own database, but the same columns must be used, since there is no library specific setting for custom columns
The database uses the book id as a key to store the book info. So, if you remove a book, the link will be lost and you will be prompted to relink it.
On the Edit reading goal dialog, you can backup/import/clear your database.
Be careful when importing a new database: the current one will be completely replaced by the imported file. It's recommended to first backup your current database, so you can restore it in case anything goes wrong.

Requirements:

calibre 6.0 or later

Installation Steps:

Download the attached zip file and install the plugin > add to context menu or toolbar > restart calibre as described in the Introduction to plugins thread.

Getting Help:

If you need assistance using this plugin, you can check out the built-in help dialogs by clicking on the '?' icon in the upper right corner of the dialog window. Then, hover your mouse over the options, and click when the cursor changes to an arrow and a question mark.

If any doubt still persists, feel free to ask here. Also, suggestions are welcomed!

License: GNU General Public License v3 (GPL-3)

Latest calibre version tested: 8.8

Version History:

Spoiler: