[GUI Plugin] OverDrive Libby

sgmoore · 02-15-2023, 01:52 PM

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:

Fix for "[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed" error on Windows
Information about Libby's Format Locking
Setup help
Usage help
Source code
Buy ping a coffee

Version History:

Spoiler:

sgmoore · 02-16-2023, 10:00 AM

Version 0.2.101

I am looking for people to test a new beta version.
Since it is a beta you should expect some issues to occur.
Also, for anyone running in debug mode, there is quite a lot of extra detail output

Most of the changes are relating to the search and especially the advanced search option.

Changes include

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. (See partial screenshot at the bottom of this message)

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 as shown by the screenshot below
If you come across examples which are not sorted correctly or where the series is missing, please let me know.

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.
(I am not quite sure why such books should be returned by your library and it would probably make sense to hide them, but I haven't done that yet)
If you come across any books where this information is incorrect, please let me know.

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.

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

Load/Save
These are really for debugging and may be be removed at the end of the beta.
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.

Create empty entry in calibre
This option has been added to the Holds & Search tabs

This version needs to be loaded manually either from this message or from https://github.com/sgmoore/libby-cal...cts/2647419031

Any issues can be discussed here or at https://github.com/sgmoore/libby-calibre-plugin.

modified · 07-01-2023, 02:49 AM

Original first post by modified:

Spoiler:

modified · 07-01-2023, 02:50 AM

No test version newer than the latest release.

Previous Test Versions

Spoiler:

JSWolf · 07-01-2023, 05:20 AM

Does this plugin work with the ACSM Input plugin to give you an ePub on download of the .acsm file? If not, can you make it so your plugin does this?

https://www.mobileread.com/forums/sh...d.php?t=341975

modified · 07-01-2023, 06:14 AM

Quote:

Originally Posted by JSWolf

Does this plugin work with the ACSM Input plugin to give you an ePub on download of the .acsm file? If not, can you make it so your plugin does this?

https://www.mobileread.com/forums/sh...d.php?t=341975

It does work with the ACSM Input plugin, but unfortunately due to the probable calibre bug mentioned in the Known Issues list, the ACSM plugin will convert the .acsm successfully but the resulting .epub does not have calibre metadata.

JSWolf · 07-01-2023, 06:36 AM

Quote:

Originally Posted by modified

It does work with the ACSM Input plugin, but unfortunately due to the probable calibre bug mentioned in the Known Issues list, the ACSM plugin will convert the .acsm successfully but the resulting .epub does not have calibre metadata.

I suggest you report it in the ACSM Input plugin thread in case that needs to be modified to fix this problem.

modified · 07-01-2023, 07:01 AM

Quote:

Originally Posted by JSWolf

I suggest you report it in the ACSM Input plugin thread in case that needs to be modified to fix this problem.

Leseratte_10, the author of the ACSM plugin is already aware. He is the one made the calibre bug report after I reported it to him.

JSWolf · 07-01-2023, 07:21 AM

There is an easy work around. Go to the metadata editor and click the button to update the metadata from the eBook. It's the icon that looks squarish with a pencil.

modified · 07-01-2023, 08:05 AM

Quote:

Originally Posted by JSWolf

There is an easy work around. Go to the metadata editor and click the button to update the metadata from the eBook. It's the icon that looks squarish with a pencil.

That's a good tip. For anyone using a different icon set.

modified · 07-05-2023, 04:08 AM

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

compurandom · 07-05-2023, 08:56 AM

So, let's say I've already downloaded a book on another device, and I already have an empty book in my library (created by the other overdrive plugin, with corresponding library IDs).

Can I get this plugin to recognize that the book has been downloaded and then auto tag the empty book?

modified · 07-05-2023, 10:37 AM

Quote:

Originally Posted by compurandom

So, let's say I've already downloaded a book on another device, and I already have an empty book in my library (created by the other overdrive plugin, with corresponding library IDs).

Can I get this plugin to recognize that the book has been downloaded and then auto tag the empty book?

This plugin only tags books that the plugin itself has downloaded. I don't really know how an "empty book" or the OverDrive Link plugin works, but it sounds like the answer is no.

miss_p1nky · 07-06-2023, 01:35 AM

Hello, a question here, if I have a hold, do I still need to go to Libby and borrow the hold first before it appears in the plugin? Does this plugin only automatically download borrowed books?

modified · 07-06-2023, 02:40 AM

Quote:

Originally Posted by miss_p1nky

Hello, a question here, if I have a hold, do I still need to go to Libby and borrow the hold first before it appears in the plugin? Does this plugin only automatically download borrowed books?

For now, you will have to borrow the hold first in Libby. The next release will allow you to borrow an available hold when it's available.

Just to be clear, the plugin does not automatically download borrowed books. You will have to select the loan and click on Download.

07-01-2023, 02:50 AM	#4
modified Connoisseur Posts: 90 Karma: 50742 Join Date: Jan 2011 Device: PW5	Test Version No test version newer than the latest release. Previous Test Versions Spoiler: 2023-09-12 - cbb55fa - 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 more room for future 2023-09-02 - aeacd7d - 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 - 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 - Fix: Duplicate condition when finding a book in calibre library 2023-08-12 - a9218ce - New: If "Include titles without downloadable formats" is enabled at setup, loans that do not have a downloadable format will be shown (i.e. Kindle, audiobook loans). Also, when such a loan is chosen for download, the plugin will now 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: Custom columns to store borrowed/due dates, and loan type (calibre>=5.35.0) *About Format Locking Libby does not allow users to read a loan on a Kindle and still download the title as an .acsm/.epub. If you chose to read with a Kindle, the loan will not be available for download (the loan is locked to the Kindle format). Similarly, if you chose to download the .acsm/.epub, the loan becomes locked to the acsm/epub format and will not be available for reading on a Kindle. Removing a book from the Kindle/ADE/calibre does not "unlock" the loan. To do that, you have to return and borrow the book again. 2023-08-05 - 7fc49ba - New: Search tab that provides basic search across up to 24 of your linked libraries 2023-08-02 - 15042cd - New: Cards tab that provides a summary of card usage/limits - Various minor UI tweaks 2023-07-27 - 3bdb037 - New: calibre 5 compatible. Requires v5.34.0 or newer Last edited by modified; 09-19-2023 at 04:44 AM. Reason: Remove test version

07-05-2023, 04:08 AM	#11
modified Connoisseur Posts: 90 Karma: 50742 Join Date: Jan 2011 Device: PW5	New Version Released 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 Last edited by modified; 07-05-2023 at 11:40 PM. Reason: Wrong date

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
[GUI Plugin] Overdrive Link	jhowell	Plugins	1277	09-21-2024 05:02 PM
No Local Public Library. Overdrive/Libby Possible?	enuddleyarbl	Kobo Reader	2	06-08-2023 08:23 PM
Library borrowing: Overdrive vs. Libby	haertig	General Discussions	83	01-30-2023 05:21 PM
Libby, the new Overdrive App	Cosimo	News	30	12-02-2017 10:42 AM
Overdrive's Libby	Loves2Read4Fun	General Discussions	2	12-20-2016 02:32 PM

07-01-2023, 05:20 AM	#5
JSWolf Resident Curmudgeon Posts: 78,139 Karma: 142517494 Join Date: Nov 2006 Location: Roslindale, Massachusetts Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3	Does this plugin work with the ACSM Input plugin to give you an ePub on download of the .acsm file? If not, can you make it so your plugin does this? https://www.mobileread.com/forums/sh...d.php?t=341975

07-01-2023, 07:21 AM	#9
JSWolf Resident Curmudgeon Posts: 78,139 Karma: 142517494 Join Date: Nov 2006 Location: Roslindale, Massachusetts Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3	There is an easy work around. Go to the metadata editor and click the button to update the metadata from the eBook. It's the icon that looks squarish with a pencil.

07-05-2023, 08:56 AM	#12
compurandom Guru Posts: 985 Karma: 418804 Join Date: Jun 2015 Device: Rocketbook, kobo aura h2o, kobo forma, kobo libra color	So, let's say I've already downloaded a book on another device, and I already have an empty book in my library (created by the other overdrive plugin, with corresponding library IDs). Can I get this plugin to recognize that the book has been downloaded and then auto tag the empty book?

07-06-2023, 01:35 AM	#14
miss_p1nky Connoisseur Posts: 64 Karma: 636 Join Date: Aug 2022 Location: Indonesia Device: Moon+ Reader Pro	Hello, a question here, if I have a hold, do I still need to go to Libby and borrow the hold first before it appears in the plugin? Does this plugin only automatically download borrowed books?

Advert

Advert