Aha! I've solved my own problem and I've rewritten the documentation to make it more fool-proof for users like me.
Quote:
INSTALLATION
1. Download both linked plugins (current version is always at the bottom of the original post).
2. Install both linked plugins. To do this, click on "Preferences," then under the "Advanced" heading click on "Plugins." For each plugin, click on "Load plugin from file." Find the ZIP file you just downloaded, click "Open." Click "Yes" on the "Are you sure?" dialogue. Restart calibre after installing plugins.
3. Click on the "Run frating" icon (looks like an orange starburst).
4. Click on "Check and create custom column." (Optional: You can change the Column Heading through Preferences: Add Your Own Columns. Double-click on the #gr1 column, and type whatever you prefer in the "Column Heading" field. Do NOT change the lookup name.)
5. Restart calibre.
USAGE
To download ratings for an individual book (good for checking if you've done setup correctly.)
1. Click on a book title in the main calibre window.
2. Click on "Edit metadata individually".
3. Next to "Download metadata," click on the Configure Download icon (looks like a "Preferences/Settings" icon, hover-text should read "Change how calibre downloads metadata.")
4. Ensure "Goodreads_Rating" is the ONLY checked Source, then Apply changes.
5. Click on "Download metadata".
6. When the download is complete, click "OK" first for the metadata, then "OK" again for the cover.
7. Click "OK" again to save changes and close the Edit Metadata window.
8. Click on the "Run frating" icon (looks like an orange starburst).
9. Click on "Set decimal retings." After this processes, you'll see a dialogue box either confirming whether it worked ("Finished extracting rating from publisherfield - for a total of X books") or not ("Finished extracting rating from publisherfield - for a total of 0 books"). Click OK to close the dialogue. Now, in the main calibre window, in this book's row and under the gr_ratings column, you should see a number ranging from 0.0 to 5.0.
To download ratings in bulk
1. Select a range of books in the main calibre window.
2. Click on "Download metadata and covers".
3. Click on "Configure Download".
4. Ensure "Goodreads_Rating" is the ONLY checked Source, then Apply changes.
5. Click on "Download only metadata".
6. When the download is complete, click "Yes".
7. Click "OK" again to save changes and close the Edit Metadata window.
8. Click on the "Run frating" icon (looks like an orange starburst).
9. Click on "Set decimal retings." After this processes, you'll see a dialogue box either confirming whether it worked ("Finished extracting rating from publisherfield - for a total of X books") or not ("Finished extracting rating from publisherfield - for a total of 0 books"). Click OK to close the dialogue. Now, in the main calibre window, in each book's row and under the gr_ratings column, you should see a number ranging from 0.0 to 5.0.
!NOTE: When downloading metadata from your usual sources (to get book covers, tags, etc), you'll need to go back to the "Configure Download" window and select your preferred sources. When downloading Goodreads Decimal Ratings, you'll need to repeat the steps to download ONLY from Goodreads_Rating.
|