View Single Post
Old 11-13-2024, 10:44 PM   #1773
Rash
Junior Member
Rash began at the beginning.
 
Posts: 2
Karma: 10
Join Date: Nov 2024
Device: Kindle
Goodreads api key

Quote:
Originally Posted by kiwidude View Post
This plugin allows you to synchronise your book collection in Calibre with your shelves on a Goodreads.com account.

Spoiler:
Goodreads targets the social aspects of sharing your book lists with friends and family. It offers various services such as reviews, book clubs, discussions and recommendations. You can maintain shelves of books you have read, want to read, are currently reading or others of your own design.

In some cases this is information that you also want to keep track of within Calibre using tags or custom columns. Typical examples of usage of this plugin are:
  • Adding a book that you have just imported to Calibre to your 'to-read' shelf on Goodreads
  • Updating a Calibre custom column to indicate that you have read a book when syncing from your 'read' shelf on Goodreads
  • Multiple actions can be applied. e.g. in the example above you might also populate a 'Read Date' custom column and remove a 'To Read' tag from the book in Calibre.
  • Using your own genre shelves in Goodreads like science-fiction, romance etc to map to Calibre tags or a custom genre column of your choice.

Main Features:
  • Add or remove books to one or more Goodreads shelves from a selection within Calibre
  • Syncing the contents from one or more Goodreads shelves into Calibre, performing customisable actions for each shelf
  • Configure actions to be performed for when adding books to a shelf or syncing from Goodreads, such as updating tags, custom columns.
  • You can also synchronise your rating, date read and or review text custom column with your Goodreads review.
  • Ability to download tags for your books based on the shelves they are on. You can customise which Calibre tags if any each shelf name will map to and use a custom genre column instead of tags if desired.
  • Ability to upload to shelves for your books based on the tags they have been given. Applies the to the same Calibre column and shelf mappings as for the download tags feature above.
  • Link your Calibre books to a Goodreads equivalent giving you right-click access to reviews or other information for that book
  • Ability to switch editions for a linked Goodreads book
  • Ability to create Empty Books in Calibre for books you sync from a Goodreads shelf
  • Optionally update the ISBN in Calibre to match the edition on your Goodreads shelf
  • Supports multiple Goodreads user accounts if required for users sharing a single operating system account
  • Help file web page available from the configuration dialog or plugin menu

Special Notes:
  • Help Documentation
  • Change History
  • Please don't abuse this plugin by using it to put many hundreds or thousands of books on your shelves. Goodreads T&C require a very limited threshold on the number of API calls per minute. Worst case they will block the plugin and that ruins it for everyone. You can use CSV export/import to Goodreads for large volumes if you need it. Refer to the help page within the plugin for the full details.
  • Requires Calibre v0.8.18 or later.

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!
Hi.
I'm building an app for my college graduation project.

I need to get users goodreads data with OAuth, and the rating of the books etc.

How can I do that? Can I get a legacy api or an api just for my project, the prof insists that I find a way to do it.

Last edited by chaley; 11-14-2024 at 03:58 AM. Reason: Added spoiler for very long quote
Rash is offline   Reply With Quote