View Single Post
Old 02-15-2023, 12:52 PM   #1
sgmoore
Groupie
sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.sgmoore ought to be getting tired of karma fortunes by now.
 
Posts: 158
Karma: 652856
Join Date: Mar 2021
Device: Kindle Voyage
OverDrive/Libby Integration for calibre

OverDrive Libby is a UI plugin that displays your Libby loans and holds and allows you to search for new books, borrow and return them.

Originally written by "modified", now maintained by "sgmoore"

Requires calibre 5.34.0 or newer.



Main Features:
  • Import loans as empty books
  • View and borrow holds
  • Monitor magazines for new issues
  • Simple search across your linked libraries

Integrates with the OverDrive Link plugin.

Install:
  • Open Preferences > Plugins > Get new plugins and install the "OverDrive Libby" User interface action plugin.
  • Alternatively, you may also download the attached zip file and install the plugin manually, then restart calibre as described in the Introduction to Plugins thread.

Setup:

Detailed setup help
  • To configure this plugin, you must already be using Libby on a compatible device.
  • Open the plugin settings (Preferences > Advanced: Plugins > Search for "overdrive libby" and then click on the "Customize plugin" button). You will be prompted to enter a Libby setup code that you can get by following the instructions here.
  • You should only need to do this setup once. Then add the plugin to the toolbar/menubar as you wish.

Usage:

Detailed usage help

Loans
  • Launch the OverDrive Libby plugin UI and select the loans you wish to download. Then click on the Download button.
  • Each selected loan will then be downloaded in its own calibre job. When the job completes, the loan book file should be in your library.
  • Only downloadable loans will be listed. If the loan does not have a downloadable format, or has previously been sent to your Kindle, it will not be displayed (unless the "Include titles without downloadable formats" is enabled).
  • To return a loan or to view the title on the Libby/OverDrive site, select and right-click on the row, then select the appropriate action.

Holds
  • Select the "Holds" tab. Select the available hold you wish to borrow, then click on the Borrow button.
  • Each selected hold will then be borrowed in its own job. When the job completes, click the "Refresh" button to see the new loan in the "Loans" tab.
  • Alternatively, right-click on the Borrow button to choose the "Borrow and Download" action. This will borrow and download the selected hold.
  • To list unavailable holds, uncheck the "Hide unavailable holds" checkbox.
  • To cancel a hold, select and right-click on the row, then select "Cancel hold".
  • To suspend a hold, or delay delivery, right-click and select "Manage hold". Use the slider to set the number of days to suspend/delay for, then click on "Update".

Magazines
  • Select the "Magazines" tab. From this tab, you can add magazines to monitor for new issues.
  • From the Libby/OverDrive site, copy the URL of the magazine you want to monitor. Paste the URL into the textbox, and select the Card to use for future borrowing. Then click on the "Add" button.
  • The title will then be listed below with its details. To borrow a title, select the row and click on the Borrow button.
  • To stop monitoring a title, select and right-click on the row, then select "Cancel".

Search
  • A basic search for up to 24 of your libraries (configured in settings).
  • Depending on availability, you can choose to borrow or place a hold on the title.

Special Notes:
Version History:

Spoiler:


Version 0.3.0 - 2026-02-09

More details
Some searches produce more results than can be returned with one query. For example if you search for books by Agatha Christie, there may be several hundreds matches. In such cases, the search button changes to allow you to retrieve more pages.
Please note, at the moment this only works when using the advanced search option.

Extra Columns
I have added two columns to the search screen to show series and wait times.

Series
If you sort by series, it should attempt to sort as best it can. It should cope with simple numbers.

Wait days
If you have multiple library cards, then this will show the smallest wait time .
If this is n/a it probably means that none of your libraries have any copies of the book.

The wait days has also been added to the submenu that displays when you place a book on hold. If you have multiple library cards, this allows you to select the library with the shortest wait time. (See https://github.com/sgmoore/libby-cal...lugin/issues/7)

A column for Wait days has also been added to the loans tab.

Load/Save
These options allow you to save search results and reload them at a latter date, but obviously that can lead to stale and inaccurate data.
These are really for debugging and may be be removed at some point.

Create empty entry in calibre
This option has been added to the Holds & Search tabs (See https://github.com/sgmoore/libby-cal.../discussions/3)

Privacy
More personal/sensitive information has been removed or redacted from the log files including email address.


Other Minor changes
Maximum number of search results increased to 100.
Logging of JSON data has been reformatted to make it easier to read.

Other Minor Fixes
Fixed issue with saving column width
Possible fix for issue with lucky day loan
No longer displays option to 'Borrow and download' loan as that feature does not work.
Fix for issue with custom column names : See https://github.com/sgmoore/libby-cal...ugin/issues/12
Fixed Inconsistency with multiple items selected on the loans tab (See https://github.com/sgmoore/libby-cal...ugin/issues/13)



Version 0.2.3 - 2025-02-07
Fix for missing cardName producing KeyError

Version 0.2.2 - 2024-11-06
Fixed issue generating new token when the existing one expires

Version 0.2.0 - 2024-11-05
This is the first official release since ping's version 0.1.9 released on 9th Sep 2023

- Fix: Renamed Download button to 'Open in libbyapp.com' as it no longer downloads anything
- Fix: Amended setup procedure to take a token or sonos setup code.
- New: Added option to create an empty entry in calibre for all loan types.
- Fix: Generates correct Odid reference for audiobooks which fixes ping#16

Version 0.1.9.2 - 2024-10-26 Unofficial version

- Fix: If API calls fail with Forbidden, attempt to fetch a new chip and retry (Credit goes to https://github.com/buske/libby-calibre-plugin)

Version 0.1.9a - 2024-09-11 Unofficial version

- Fix: Uses libbyapp.com domain rather than svc.overdrive.com which fixes ping#33
- Fix: Applied spicefather's fix for date time formats (see ping#17)

Also includes unreleased changes by ping including the following

- New: Rename a card
- Fix: Use a regex validator instead of input mask for Libby setup code due to wonkiness, ref ping#14


Version 0.1.9 - 2023-09-19
- Fix: Error on launch for calibre <6.2.0
- New: Option to disable the Magazines tab
- Improve: Convert configuration UI to use tabs so that there is room for more settings in the future

Version 0.1.8 - 2023-09-05
- New: Advance search mode
- New: Simple filter for titles and names in the Loans/Holds/Magazines/Cards tabs
- New: Copy the Libby share link for a book
- New: Verify a card
- New: Generate a setup code (for another device)
- Improve: Display linked identifiers, subjects in Book Details
- Improve: Infrequently changed data like libraries are now cached to give sync a small speed bump
- Improve: Card image in cards tab is not fuzzy anymore
- Fix: Borrowing with a card that has no lending period preference
- Fix: Display of rating in book details
- Fix: Properly update empty book without any identifiers (ref #8)
- Fix: Duplicate condition when finding a book in calibre library
- Fix: Error when library does not have default colours setup (ref #11)

Version 0.1.7 - 2023-08-20
- New: If "Include titles without downloadable formats" is enabled, titles that do not have a downloadable format will be shown. In addition, when the title is chosen for download, the plugin will create an Empty Book
- New: Read with Kindle option is available for loans that are available as Kindle books and not already format-locked
- New: Search tab that provides a basic search function across your libraries
- New: View book details by double-clicking on the row
- New: Cards tab that gives an overview of your linked cards
- New: Custom columns to store borrowed/due dates, and loan type (calibre>=5.35.0)
- New: Renew/place hold for an expiring loan
- New: Display number of available holds in the Holds tab text
- New: Last used tab will be opened by default
- New: Disable borrow button if limits for the card has been reached
- New: Compatible with calibre 5.34.0 and newer

Version 0.1.6 - 2023-07-22
- Fix: Error if loan was sent to Kindle
- Fix: Issue for Windows where window size is not restored properly
- New: Add option to disable updating of existing empty books
- New: Indicate if loan is a skip-the-line checkout
- Improvement: Update more book metadata from loan details
- Improvement: Match empty books for update using title/ISBN/ASIN even if OverDrive Link Integration is not enabled
- Improvement: Make UI more keyboard navigable

Version 0.1.5 - 2023-07-15
- New: Option to "Borrow and Download" from the Borrow button for loans/magazines
- New: Edit a hold to suspend or delay delivery
- New: Option to mark books that have been updated with a new format
- New: Option to exclude/include empty books when hiding titles already in library
- Disable Borrow button if a magazine issue is already borrowed
- Generate the "odid" identifier for a new download if user has the OverDrive Link plugin installed
- Fix title matching for book that has a subtitle
- Fix regression where generated magazines temp files were not being properly deleted
- Fix layout wonkiness
- Localize date values
- Switch to using svg image files for icons, so plugin zip is now smaller

Version 0.1.4 - 2023-07-09
- New: Borrow and cancel holds
- New: Fave magazines to monitor for new issues
- Integration with the OverDrive Link plugin: If an existing book has a matching OverDrive link and no formats, the loan download will be added to the book.
- Fixed issue with converted .acsm downloads not having metadata
- Add option to View in OverDrive
- Sort titles with sort name instead of name
- Colored icons
- Implement loading overlay

Version 0.1.3 - 2023-07-05
- New: View loans in Libby (from context/right-click menu)
- New: Return loans (from context/right-click menu)
- New: Auto tag downloaded books
- Properly display Checkout Date according to preferences
- Increase concurrent loan downloads
- Main loans window is now modal
- Use icons instead of unicode symbols for buttons
- Removed Verbose Logs option from config
- Improved implementation for Download, Refresh buttons
- Detect invalid Libby setup code format early
- Reduced zip file size by removing unneeded translation files

Version 0.1.2 - 2023-07-02
- Plugin now remembers the size of the main loans window

Version 0.1.1 - 2023-07-01
- Plugin no longer locks up while fetching loan data

Version 0.1.0 - 2023-07-01
- First release
Attached Files
File Type: zip overdrive-libby-plugin-0.3.0.zip (148.8 KB, 3510 views)

Last edited by sgmoore; 02-09-2026 at 12:25 PM. Reason: Updated for Version 0.3.0
sgmoore is offline   Reply With Quote