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

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

humble-cli

The missing CLI for downloading your Humble Bundle purchases!

Build status

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)

Install

You can find the binaries in the Releases page. Windows, macOS and Linux are supported.

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.9.0
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
    details         Print details of a certain bundle
    download        Selectively download items from a bundle
    help            Print this message or the help of the given subcommand(s)
    list            List all your purchased bundles
    list-choices    List your current Humble Choices

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