[GUI Plugin] Integrity Analysis

[Comfy.n]

Integrity Analysis added to Index of Plugins.

[dunhill]

Originally Posted by Comfy.n

Integrity Analysis added to Index of Plugins.

Thank you, moderator

[Rellwood]

Great plugin! Two suggestions:

1 - Mark books that are problematic

2 - Allow a .json to be created that would allow compiling exclusions. I have books that are just empty records - I can't seem to get the plugin to move past this and give me an acurate for my library report.

[dunhill]

Originally Posted by Rellwood

Great plugin! Two suggestions:

1 - Mark books that are problematic

2 - Allow a .json to be created that would allow compiling exclusions. I have books that are just empty records - I can't seem to get the plugin to move past this and give me an acurate for my library report.

Try this version and tell me if I was right

[Rellwood]

You did GOOD with it! I really like it now, it marked the problems, it gave me a list and it allowed me to exclude them from checks AND a note?? Thanks - where's your donation button?

[Rellwood]

Ok, so here is what Im thinking - the log is helpful, but it's kind of a blur if there are a lot of books. I know that you have made the marked books the mark "RED" - suppose you allow configuration to set the mark color and tag per specific reason - like "no cover" or "no format" vs "missing format" vs whatever it is that this plugin finds. Allow the user to define the mark color (if possible) and or a label that goes with the specific problem. The log is good, but I think being able to just see the marks and see the problem will make it easier to scroll through larger libraries with a lot of different issues or a library with a ton of blank books and find the actually missing books rather than hunt through the log. Does that make sense?

[Rellwood]

Sorry, I didn't realize that I could configure it to exclude non-formats. Im blind tongiht.

[dunhill]

Originally Posted by Rellwood

You did GOOD with it! I really like it now, it marked the problems, it gave me a list and it allowed me to exclude them from checks AND a note?? Thanks - where's your donation button?

Thank you, I’m really glad it’s working well for you now! Your suggestions made the plugin better, so thanks for that too. No donate button, it’s a hobby project and feedback like yours is reward enough. If you want to support someone, consider donating to Kovid to keep calibre going. 🙂

[igorius]

Maybe a dumb question:

I know that you have made the marked books the mark "RED" - suppose you allow configuration to set the mark color and tag per specific reason

What gets marked? I dont see any mark nor red colour? What do i miss?
Marking books (or a predefined column) based on the kind of "problem" would be such a great thing!
My problems consist in empty books (still not published or i dont have them), so finding them by a different colour would be so extremely beautiful!
Great plugin! Thanks a lot!!!

[dunhill]

Hi! @igorius Thanks again for the suggestion. Here’s a test version (1.7.0) with what you asked for. Please try it and let me know how it works for you before I publish it officially.

First, about the marks: calibre marks have no color. Marked books just show a small mark icon next to the row number. That’s why you couldn’t see any red. This version adds real colors through a custom column.

What’s new

1. One mark per problem type
Each book is now marked according to its main problem: integrity_no_formats, integrity_cover, integrity_opf, integrity_folder, integrity_format_file or integrity_error. If you prefer the old single mark, you can switch back to it in the settings.

2. Show books by problem type
There’s a new submenu that lists every book with a given problem, even when it isn’t the book’s main one. After a scan, each option shows how many books are affected, for example “No formats (12)”. The report also includes a summary by problem type.

3. Problems column (for colors)
The plugin can write the problem types of each book to a custom column, for example “No formats, Cover”. Books with no problems, and excluded books, are left empty. Unlike marks, the column is kept after you restart calibre. You can also search it, or click it in the Tag browser.

4. Automatic setup of the column and the color rules

After a scan that finds problems, the plugin offers to create the column for you. calibre opens its usual “Add column” window, already filled in, so you only need to confirm it.
Right after that, the plugin offers to add ready-made color rules. You choose which problem types to color, pick the colors, and decide what to paint: the whole row, the title, the authors or the column itself.
Restart calibre and run the analysis again. Your empty records will show up in red.
These are normal calibre rules, so you can edit or delete them later in Preferences → Look & feel → Column coloring. The same menu also has “Add color rules…” and “Remove color rules”. Removing only deletes the plugin’s rules; your own rules are never touched.

5. Language-aware
The column and the rules are created in your calibre interface language. If you change the language later, the next scan updates the column values and the color rules to the new language, and keeps your colors.

Tip for your case (empty records): once the column and the color rules are set up, your books without formats will be shown in red. You can also list them with “Show books by problem type → No formats”. If some of them should never be reported, use Exclusions → “Exclude selected books” and choose “Book without formats”.

Everything is also explained in the plugin’s Help (plugin menu → Help).

Feedback is welcome!