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
128 downloads per month
58KB
1.5K
SLoC
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