Release 0.8.1

Changes:

• Improve: Speed up concatenation of mp3, ref #51
• Fix: Error due to unexpected date string format, ref #53
• Fix: Error when unable to download audiobook supplementary content, ref #54

To install/upgrade:

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

Release 0.8.0

Changes:

• New: Extract audiobook supplementary content
• New: Allow user to specify chars to strip from paths on top of the ones already removed, ref #48
• Improvement: In book name/folder formats, use title ID instead of reserve ID for libby ODM-based downloads, ref #47
• Improvement: Move default libby config folder to os defaults, ref #49

To install/upgrade:

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

Release 0.7.9

Changes:

• New: Magazines now have a generated contents page
• New: %(ReadingOrder)s format field for --bookfolderformat/--bookfileformat
• New: --mergecodec option that adds support for using libfdk_aac when encoding a merged m4b (#45)

To install/upgrade:

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

Release 0.7.8

Changes:

• Fix: MP3 ID3 language tag
• Improvement: Do not update mp3 ID3 unless it is a new download
• Improvement: The table of contents for magazines are now grouped by sections
• New: --noaudiobooks option to exclude audiobooks in libby mode
• New: --id3v2version option to customise the ID3 tag version used

# use ID3 v2.3
odmpy libby --id3v2version 3
# use ID3 v2.4 (default)
odmpy libby --id3v2version 4

To install/upgrade:

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

Release 0.7.7

There are no major functional changes in this release. This upgrade is optional if you're not facing any problems.

Changes:

• Pin minimum versions for dependencies to avoid compat problems
• Be consistent about 0-padding for internal chapter IDs

To install/upgrade:

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

Release 0.7.6

Changes:

• Bug fix getting high-res ebooks/magazines cover images
• Bug fix ebooks direct download due to unknown mimetype
• Bug fix handling of invalid choices in libby commands
• Bug fix warning when overwriting tags for an audiofile with existing ToC
• Improved EPUB3 conformance for generated magazine epubs

To install/upgrade:

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

Release 0.7.5

Changes:

• odmpy now supports the specification of the libby identity token through the environment variable LIBBY_TOKEN. This allows the usage of libby commands without persisting credentials to file

• libby: New option --selectid to support downloading selected loans by title ID in a non-interactive mode

  # Download loans with the IDs 1234 9876
  odmpy libby --selectid 1234 9876

• New title ID field support for --bookfolderformat / --bookfileformat

  # Downloaded file name will be "A Study in Scarlet_1234.epub" where "1234" is the title ID
  odmpy libby --ebooks --bookfileformat "%(Title)s_%(ID)s"

• Fix error for Windows when inordinately long folder names are generated

To install/upgrade:

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

Release 0.7.4

Changes:

• --ebooks now includes PDF ebook loans. Similar to EPUB loans, a DRM PDF loan will be downloaded as an .acsm file while an Open PDF loan will download as a .pdf
• The generated .opf filename (with --opf) now follows the ebook/audiobook filename format
• Returning an .odm loan file now properly respects the retry and timeout options
• Improvements in the metadata generated for magazines/ebooks

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

To install/upgrade:

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

Release 0.7.3

Changes:

• Fix download (fulfillment) error, ref #37
• Magazines: The title in the epub metadata now includes the magazine edition, e.g. "The New Yorker - Mar 06 2023"
• Direct from Libby eBooks and magazines now have higher resolution cover images
• Fix epub generation for Windows

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

To install/upgrade:

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

Release 0.7.2

Changes:

• Fix setup error introduced in 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

To install/upgrade:

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