ping / libby-calibre-plugin

OverDrive Libby Plugin for calibre
https://www.mobileread.com/forums/showthread.php?t=354816
GNU General Public License v3.0
73 stars 16 forks source link
calibre ebook ebooks libby magazine magazines overdrive

main OverDrive Libby Plugin for calibre

OverDrive Libby is a plugin that allows you to directly import your Libby loans into calibre.

Requires calibre 5.34.0 or newer.

Main Features

This plugin is compatible with the ACSM Input plugin for converting .acsm files into .epub.

Also integrates 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.

Buy me a coffee

Install

Open Preferences > Plugins > Get new plugins, and install the "OverDrive Libby" User interface action plugin.

You may also download the latest plugin zip file from Releases and install the plugin manually, then restart calibre as described in the Introduction to Plugins thread.

To try out unreleased versions, go to GitHub Actions, and click on the latest run. The downloadable artifact, e.g. overdrive-libby-plugin-1a2b3c4 will be an installable plugin zip. You will need to be logged in to GitHub to download artifacts.

Setup

To configure this plugin, you must already be using Libby on a compatible device.

Open the plugin customization settings (Preferences > Advanced: Plugins > Search for "overdrive libby" and then click on the "Customize plugin" button).

settings

Get a Libby setup code by following the instructions here. Enter the 8-digit code into the plugin settings and click "OK". If you encounter an error, the code may have expired. Get a new one and try again.

You should only need to do this setup once. Then add the plugin to the toolbar/menubar as you wish.

Help

Loans

Holds

Search

General

Network

Usage

Loans

Loans

Launch the OverDrive Libby plugin, and click on the "Loans" tab. 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 shown unless "Include titles without downloadable formats" is enabled in setup.

Select a row, right-click and select the appropriate action to:

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.

Holds

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.

Select a row, right-click and select the appropriate action to:

Edit Hold

Magazines

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

Search

The "Search" tab provides a basic search function across your libraries. The libraries to search and the number of results returned can be customised in setup. To borrow or place a hold, select a title, then click on the Hold or Borrow button and select the card you wish to use.

Cards

Cards

The "Cards" tab provides an overview of the linked cards in your Libby account. Right-click on the Library name, Loans, or Holds to view the respective pages on OverDrive or Libby.

FAQ

[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed error on Windows

Download the Let's Encrypt R3 certificate https://letsencrypt.org/certs/lets-encrypt-r3.der. Import it into the Windows certificate store by double-clicking on the file and follow the subsequent prompts.

Why can't I see my all loans?

If you wish to see loans that are not fully downloadable (e.g. Kindle loans, audibooks), enable the "Include titles without downloadable formats" option in setup.

Why is a loan downloaded without any formats (acsm/epub)?

This is because the loan does not have a supported downloadable format available. The loan is either not available in epub/pdf, or you have chosen to Read with Kindle (see above for details about Format Locking).

Why can't I download a particular magazine?

Not all magazines are downloadable. Only magazines that have readable individual articles can be downloaded.

Credit

Disclaimer

This is not affliated, endorsed or certified by OverDrive. To use this plugin, you must already have access to OverDrive services via a valid library account. Use at your own risk.