humble-books-dl 0.1.0

Download Books Bundle purchases from Humble Bundle via the command line.

humble-books-dl

A command-line tool for downloading Books Bundle purchases from Humble Bundle.

Installation

pip install humble-books-dl

Usage

Find your order KEY in the Humble Bundle purchase confirmation email or in the URL when viewing a bundle on humblebundle.com.

List all items in a bundle:

humble-books-dl list <order_key>

Download a bundle:

humble-books-dl download <order_key>

Download a single item by number:

humble-books-dl download <order_key> --item 3

By default, files are saved to ~/HumbleBundle/<bundle name>/ and formats are tried in the order epub -> pdf -> mobi. Files that already exist on disk are skipped.

All download options:

Flag	Description
--item N	Download only item N (as shown by the list command)
--formats	Preferred formats in priority order. Falls back to all available if none match.
--output	Download directory (default: ~/HumbleBundle)
--no-progress	Disable progress bars

Python API

from humble_books_dl import HBPurchase

purchase = HBPurchase.from_order_key("ORDERKEY")
purchase.list_products()

purchase.download_all("~/HumbleBundle", formats=["epub", "pdf"])
purchase.download_product(3, "~/HumbleBundle", formats=["epub", "pdf"])

License

MIT