#bundle #download #size #items #content #humble #purchases

bin+lib humble-cli

The missing CLI for downloading your Humble Bundle purchases

11 releases (7 breaking)

0.14.1 Jun 2, 2024
0.14.0 Dec 25, 2023
0.13.1 Dec 3, 2023
0.13.0 Oct 26, 2023
0.8.0 Feb 25, 2023

#1678 in Command line utilities

Download history 5/week @ 2024-02-26 58/week @ 2024-04-01 126/week @ 2024-05-27 63/week @ 2024-06-03

189 downloads per month

MIT license

56KB
1.5K SLoC

Build status GitHub GitHub release (with filter)

humble-cli

The missing CLI for downloading your Humble Bundle purchases!

Features

  • List all your Humble Bundle purchases
  • See contents of each bundle, along with file formats and their size
  • Download items in a bundle, with the option to
    • filter them by format (epub, pdf etc.)
    • filter them by size
    • download only selected items (by index)
  • See which bundles have unclaimed keys
  • Check your Humble Bundle Choices in current and previous months
  • Search through all your purchases for a specific product

Install

Option 1: Download the binaries in the Releases page. Windows, macOS and Linux are supported.

Option 2: Install it via cargo:

cargo install humble-cli

Usage

To start, go to the Humble Bundle website and log in. Then find the cookie value for _simpleauth_sess. This is required to interact with Humble Bundle API.

See this guide on how to find the cookie value for your browser: Chrome, Firefox, Safari.

Use humble-cli auth "<YOUR SESSION KEY>" to store the authentication key locally for other subcommands.

After that you will have access to the following sub-commands:

$ humble-cli --help
humble-cli 0.14.1
The missing Humble Bundle CLI

USAGE:
    humble-cli <SUBCOMMAND>

OPTIONS:
    -h, --help       Print help information
    -V, --version    Print version information

SUBCOMMANDS:
    auth            Set the authentication session key
    completion      Generate shell completions
    details         Print details of a certain bundle [aliases: info]
    download        Selectively download items from a bundle [aliases: d]
    help            Print this message or the help of the given subcommand(s)
    list            List all your purchased bundles [aliases: ls]
    list-choices    List your current Humble Choices
    search          Search through all bundle products for keywords

Note: `humble-cli -h` prints a short and concise overview while `humble-cli --help` gives all
details.

Dependencies

~16–31MB
~439K SLoC