hb_downloader

Simple script to download purchases from humble bundle account.

By default, script download multiple files at once, starting with the biggest files. Script will only download files specified by platform parameter. Platform parameter is based on platform selection in HB Library.

Script only download files once even if it was purchased in multiple bundles. It will be saved in the oldest bundle/purchase folder.

To not download files multiple times, hash of file is computed and compared with one provided by HB, so if HB will update files it will overwrite existing one.

By default, file are saved in following folder structure:

platform/date of purchase bundle name/item name

This structure helps with importing e-books into calibre, so each e-book will be in separate folder with multiple available formats.

Requirements

Python in version 3.x or higher, accessible in command line

Script require few additional non-standard packages. Install them with

pip install python-slugify ruamel.yaml requests loguru --user

For Windows systems script require removing 260 path name limit, otherwise download of some files will fail or script will try to redownload files with long file names.

Usage

Make config.yaml file based on example_config.yaml and provide _simpleauth_sess cookie from browser between apostrophes.

Providing switches for download_limit and purchase_limit ignore default values from config.yaml file.

usage: hb_downloader.py [-h] [-l X] [-n Y] [-s] platform [platform ...]

Download files from Humble Bundle, based on selected platform

positional arguments:
  platform              platform to download, valid platforms are: ['android', 'audio', 'ebook', 'linux',
                        'mac', 'windows', 'video, other', 'nogames', 'all']

options:
  -h, --help            show this help message and exit
  -l X, --download_limit X
                        Download X files in parallel
  -n Y, --purchase_limit Y
                        Download only from Y newest purchases, 0 for all --default
  -s, --smallest_first  Download smallest files first

You can specify multiple platforms to download, for example to download all audio albums, and all e-book files:

python hb_downloader.py audio ebook

To download all files from HB account use:

python hb_downloader.py all

To download all files, but not games:

python hb_downloader.py nogames

By default, script download multiple files at once, starting with the biggest files. You can limit maximum parallel downloads by specifying download-limit, to download 6 audio files at once use:

python hb_downloader.py -l 6 audio

To download only files from the latest purchase use purchase-limit option, for example to download only e-books from last 5 bundles use:

python hb_downloader.py -n 5 ebook

Above example will skip files if they were in previous bundles purchased, so it recommended use is to update downloaded collection by newest purchased bundles not downloaded before. If purchase-limit option is omitted all previously downloaded files will have their hash recomputed which will slow down overall process of downloading.

Trove

In 2020-11-01 ability to download trove games was added.

By default script don't try to download trove games, it can be enable in config file or by using --trove switch. Trove games are inside windows/linux/mac folder in 2010-11-24 trove directory. If reported md5sum for trove games is identical to games from other purchase, then it will be put in corresponding purchase folder and not trove directory.

Script don't have ability to download only trove games

Trove support was dropped on 2022-02-15, because Humble Bundle no longer provide it.

podman/docker

On 2022-08-08 created podman/docker image for easy use.

To download image use:

podman pull ghcr.io/tokariew/hb_downloader:latest

Basic run looks like:

podman run -it --rm -v .:/srv:z hb_downloader:latest all

Above command at first run will create config.yaml file and fail, edit the file by providing session_cookie and run it again. Don't edit download_folder unless you properly change container volume. Files will be downloaded into current folder. You can change it by changing volume location for example:

podman run -it --rm -v ~/Downloads/hb:/srv:z hb_downloader:latest all