#purchase #size #product #key #humble-bundle #humblebundle

bin+lib humble-cli

The missing CLI for downloading your Humble Bundle purchases

22 releases (11 breaking)

new 0.18.0 Apr 20, 2025
0.17.1 Mar 7, 2025
0.17.0 Jan 31, 2025
0.16.5 Dec 10, 2024
0.8.0 Feb 25, 2023

#1076 in Command line utilities

Download history 3/week @ 2025-01-07 120/week @ 2025-01-28 25/week @ 2025-02-04 6/week @ 2025-02-11 3/week @ 2025-02-18 4/week @ 2025-02-25 127/week @ 2025-03-04 14/week @ 2025-03-11 1/week @ 2025-03-18 1/week @ 2025-04-08 127/week @ 2025-04-15

128 downloads per month

MIT license

58KB
1.5K SLoC

Build status GitHub GitHub release (with filter)

humble-cli

The missing command-line interface for downloading your Humble Bundle purchases!

✨ Features

  • List all your Humble Bundle purchases
  • List entries in a bundle, their file formats, and file size
  • Download items in a bundle separately, and optionally filter them with
    • file format (e.g., EPUB, PDF)
    • file size
  • Easily see which of your 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
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

~17–29MB
~423K SLoC