Quick and dirty script to download all games, for all operating systems, from Humble Vault (formerly known as Humble Trove). This does not download all games from the Humble App- It only downloads the "Vault" games. You need a Humble Choice subscription to download these games.

Existing files have their md5 checksums checked versus what the Humble Bundle API reports. If there is a mismatch, you'll need to delete or move the offending file and run the script again.

Install PHP and Composer. If you are using Linux, these should be available from your distribution's package repositories.

After cloning this repository, run composer in the project's main directory to install dependencies:

$ composer install

See the instructions here on how to get a session key from your browser while logged into the Humble Bundle website. This script will not work without it.

$ ./src/download.php DOWNLOAD_PATH HUMBLE_API_KEY

Example (this is not a real key):

$ ./src/download.php /home/downloads/humble "eyJ1GzZJE0oqwEaunyOYX3yrlkFUxPJq8PFWCgkKOHM00\075|1566665561|JR7m2nO769sO2Je4C2fE"

You can exclude operating systems with the -o parameter and games with the -g parameter. To exclude multiple, specify them in a comma-separated list as follows:

$ ./src/download.php -o mac,linux -g game1,game2,game3 /home/downloads/humble "eyJ1GzZJE0oqwEaunyOYX3yrlkFUxPJq8PFWCgkKOHM00\075|1566665561|JR7m2nO769sO2Je4C2fE"

-o can be "mac", "linux", and/or "windows". -g should be the "machine name" of the games, which are output in square brackets when downloading:

Processing The Flame in the Flood [theflameintheflood_vault]...

In the above example, you should use theflameintheflood_vault when using the -g parameter.

A docker image is available so you don't need to setup PHP or deal with dependencies:

$ docker run -it \
    -v /your/path/to/downloads/folder/:/downloads \
    -u $(id -u):$(id -g) \
    slashbunny/humble-vault-downloader:latest /downloads "eyJ1GzZJE0oqwEaunyOYX3yrlkFUxPJq8PFWCgkKOHM00\075|1566665561|JR7m2nO769sO2Je4C2fE"

Your API key is wrong. Double check is it correct and quote it the same way in the example under Usage.