Skip to content

📦 The missing CLI for downloading your Humble Bundle purchases

License

Notifications You must be signed in to change notification settings

smbl64/humble-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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
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.