Release 0.7.1

📝 Reminder
The --retry/-r option has been moved to the base odmpy command (similar to --timeout/-t) for consistency from release 0.7.0

Changes:

• Experimental. Support direct from Libby download for eBooks using the new --direct option. Instead of an .acsm file, an .epub generated from the web Libby version of the book will be downloaded. This is different from the .epub that you get when you use an .acsm loan file with ADE.

  odmpy libby --ebooks --direct

• Experimental. Using the new --magazines option will allow you to download/return/renew magazine loans.
  When downloading, odmpy will download the web Libby version of the magazine as an .epub. This is different from the Libby app downloaded copy (for offline reading) and is usually smaller in file size.

  odmpy libby --magazines
  odmpy libbyreturn --magazines
  odmpy libbyrenew --magazines

• New option --bookfileformat to support basic customization of the book file name for merged audiobooks, ebooks, and magazines.

  # Downloaded file will be "downloads/Arthur Conan Doyle/A Study in Scarlet.mp3"
  odmpy dl --downloaddir "downloads" --merge --bookfolderformat "%(Author)s" --bookfileformat "%(Title)s"
  # Downloaded file will be "downloads/National Geographic/Jan 1 2023.epub"
  odmpy libbyreturn --magazines  --downloaddir "downloads" --bookfolderformat "%(Title)s" --bookfileformat "%(Edition)s"

To install/upgrade:

python3 -m pip install git+https://git@github.com/ping/odmpy.git@0.7.1 --upgrade

Release 0.7.0

Changes:

• ⚠️ BREAKING: The --retry/-r option has been moved to the base odmpy command (similar to --timeout/-t) for consistency

  # previously
  odmpy dl --retry 3 "MyLoan.odm"
  odmpy libby --retry 3
  
  # now
  odmpy --retry 3 dl "MyLoan.odm"
  odmpy --retry 3 libby

• New libbyreturn command to return your audiobook loans via Libby

  odmpy libbyreturn

• New libbyrenew command to renew your audiobook loans via Libby

  odmpy libbyrenew

• New --ebooks option for libby-related commands to include ebooks (EPUB) loans. An EPUB (DRM) loan will be downloaded as an .acsm file which can be opened in Adobe Digital Editions for offline reading. An open EPUB (no DRM) loan will be downloaded as an .epub file which can be opened in any EPUB-compatible reader.

  # include epub ebook loans
  odmpy libby --ebooks
  odmpy libbyrenew --ebooks
  odmpy libbyreturn --ebooks

• Improved Windows compatibility

Release 0.6.7

Changes:

• New option --bookfolderformat to support basic customization of the book folder name

  # Example output folder will be "downloads/A Study in Scarlet/"
  odmpy dl --downloaddir "downloads" --bookfolderformat "%(Title)s"
  
  # Example output folder will be "downloads/Arthur Conan Doyle/A Study in Scarlet/"
  odmpy libby --downloaddir "downloads" --bookfolderformat "%(Author)s/%(Title)s"
  
  # Example output folder will be "downloads/Arthur Conan Doyle/Sherlock Holmes/A Study in Scarlet/"
  odmpy libby --downloaddir "downloads" --bookfolderformat "%(Author)s/%(Series)s/%(Title)s"
  

• libby: New option --select to support downloading selected loans in a non-interactive mode

   # Download 5th and 7th checked out loan
  odmpy libby --select 5 7

Release 0.6.6

Changes:

• Restores support for Python 3.7 and 3.8

Release 0.6.5

Changes:

• libby command:
  • Sort loans display by checkout date
  • Support "0" as a shortcut for the latest loan number in interactive mode
  • New --exportloans /path/to/loans_info.json option to export loans information to a JSON file non-interactively
  • New --latest N to download the latest N loans non-interactively

Release 0.6.4

Changes:

• Improve ID3 tag output
• Add --overwritetags option to force odmpy to always overwrite existing ID3 tags
• Add --tagsdelimiter option to specify the delimiter for writing multiple values to a tag, e.g. authors will be written as "Author A;Author B;Author C" to the artist tag. Defaults to ";".
• Store OverDrive ID (media ID if using libby --direct or reserve ID if using odm) as a custom user text ID3 tag
• OPF: Remove the opf:file-as property for <dc:title> tag since it is non-standard

Release 0.6.3

Changes:

• libby: Support choosing multiple loans for download

• Support OPF generation with the option --opf when downloading. The .opf file will be saved in the book folder.

  # download with odm
  odmpy dl test.odm --opf
  
  # download with libby
  odmpy libby --opf

Release 0.6.2

Changes:

• Resuming downloads will continue from partially download .part files (instead of starting over)

• Clear existing Libby settings with

  odmpy libby --reset

• Support downloading from Libby without extracting the odm file. This should help if odm files are no longer available in the future.

  odmpy libby --direct

Release 0.6.1

Changes:

• Move away from clint to use termcolor and tqdm for console colour output and progress bar
• libby: Don't re-download odm if it already exists so that we don't use up the fulfillment limit

Release 0.6.0

Changes:

• Integrate directly with Libby to download the odm and audiobook

odmpy libby -h