View Single Post
Old 04-23-2011, 03:25 PM   #1
kiwidude
calibre/Sigil Developer
kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.
 
Posts: 4,224
Karma: 1334002
Join Date: Oct 2010
Location: London, UK
Device: Kindle Paperwhite 3G, iPad 3, iPad Air
[Metadata Source Plugin] Goodreads

This plugin consolidates the now deprecated Goodreads Metadata and Goodreads Covers plugins with a replacement that works with the Calibre 0.8 metadata API.

It allows Calibre to read book information from goodreads.com when you choose to download/fetch metadata. Calibre currently comes with plugins for a number of information sources such as Amazon and Googlebooks. Adding this plugin can potentially increase both the success rate and quality of information retrieved for some of your books.

Main Features of v1.1.8
  • Can retrieve goodreads id, title, author, series, isbn, comments, rating, publisher, publication date, tags, language and covers
  • Option to customise the Goodreads genre -> Calibre tag mappings. A default set of the most popular genre tag mappings is included as a starting point.
  • Option to additionally search multiple editions of a book for the best set of metadata excluding audio editions (plugin will run slightly slower with this enabled, disabled by default)
  • Option to retrieve all contributors to a book as an author. By default this is turned off, however Goodreads is able to provide illustrators, editors etc should you want these retrieved.
  • By retrieving the Goodreads id this plugin offers improved integration with the Goodreads Sync plugin. This works both ways - once you have linked to a specific Goodreads edition then retrieving metadata will obtain it for only that edition.
  • The goodreads id will also be displayed in the book details panel to be clicked on and taken directly to the website for that book.

Special Notes:
  • Requires Calibre 0.8 or later.

Installation Notes:
  • Download the attached zip file and install the plugin as described in the Introduction to plugins thread.
  • Note that this is not a GUI plugin so it is not intended/cannot be added to context menus/toolbars etc.
  • Customise your desired genre -> tag mappings and other options from the Metadata download configuration screen

Paypal Donations:
  • If you find this or any of my other plugins useful please feel free to show your appreciation. I have spent many hundreds of unpaid hours in their development and support so any encouragement for me to continue is appreciated!

Version History:

Version 1.1.8 - 28 Jul 2014
Support upcoming calibre 2.0

Version 1.1.7 - 25 Aug 2013
Another fix for more.../less... on authors

Version 1.1.6 - 17 Aug 2013
Support Dutch language

Version 1.1.5 - 10 Jul 2013
Updated to match Goodreads website change which broke ISBB and cover parsing

Spoiler:
Version 1.1.4 - 04 Mar 2013
Fix for Goodreads change for when large number of authors to ensure more.../less... is removed correctly

Version 1.1.3 - 28 Dec 2012
Fix "Get all contributing authors" option
Add support for "languages" metadata field

Version 1.1.2 - 23 Jun 2012
Reject editions that do not match in title (such as different languages) and handle non-ascii characters better
Fix to handle books with short descriptions since Goodreads website change

Version 1.1.1 - 12 Jun 2012
Updated to match Goodreads website change which stopped tags being downloaded
Change to the comments to no longer strip paragraph breaks

Version 1.1.0 - 03 Mar 2012
Fix the "Scan multiple editions for title/author searches" option broken from Goodreads website change

Version 1.0.9 - 14 Nov 2011
Support case insensitive comparisons of genre tag mappings
Allow renaming an item changing only case
When sorting to display the mappings in the config screen, ignore case

Version 1.0.8 - 25 Oct 2011
If large number of authors, ensure more... and ...less is stripped from authors results.

Version 1.0.7 - 10 Aug 2011
Ensure a "close but not quite" series # does not throw an error within the plugin.

Version 1.0.6 - 21 Jun 2011
Handle change to Goodreads website which prevented title/author results returning

Version 1.0.5 - 12 May 2011
Ensure any covers less than 1000 bytes in size are ignored
No longer prefix the comments with SUMMARY: in output for consistency with other plugins

Version 1.0.4 - 08 May 2011
Remove code supporting versions prior to 0.8
Strip trailing comma from series name if it exists
Put summary comments on line following the word SUMMARY: rather than on same line.

Version 1.0.3 - 29 Apr 2011
Fix to ensure non ascii author names are parsed correctly.

Version 1.0.2 - 26 Apr 2011
Properly fix the ordering of tags.

Version 1.0.1 - 25 Apr 2011
Ensure tags mapped are returned by order of popularity not alphabetically so applying a tag threshold works better
Add support for API change upcoming in Calibre 0.7.58 allowing hyperlinked ids in book details panel

Version 1.0 - 23 Apr 2011
Initial release of plugin, rewritten consolidation of Goodreads Metadata and Goodreads Covers plugins

Attached Thumbnails
Click image for larger version

Name:	Screenshot_1_Configuration.png
Views:	2572
Size:	56.0 KB
ID:	70350  
Attached Files
File Type: zip Goodreads-qt5.zip (21.3 KB, 2875 views)

Last edited by kovidgoyal; 07-28-2014 at 03:19 AM. Reason: v1.1.8 Released
kiwidude is offline   Reply With Quote