https://github.com/smbl64/humble-cli
📦 The missing CLI for downloading your Humble Bundle purchases
https://github.com/smbl64/humble-cli
cli downloader humble-bundle humblebundle rust
Last synced: 3 months ago
JSON representation
📦 The missing CLI for downloading your Humble Bundle purchases
- Host: GitHub
- URL: https://github.com/smbl64/humble-cli
- Owner: smbl64
- License: mit
- Created: 2022-06-02T17:32:24.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-07T18:43:55.000Z (3 months ago)
- Last Synced: 2025-04-11T19:22:20.917Z (3 months ago)
- Topics: cli, downloader, humble-bundle, humblebundle, rust
- Language: Rust
- Homepage:
- Size: 3.08 MB
- Stars: 87
- Watchers: 5
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/smbl64/humble-cli/actions/workflows/tests.yml)
# 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][releases] page. Windows, macOS and Linux are supported.
**Option 2:** Install it via `cargo`:
```sh
cargo install humble-cli
```
## 🚀 Usage
To start, go to the [Humble Bundle website][hb-site] 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][guide-chrome], [Firefox][guide-firefox], [Safari][guide-safari].
Use `humble-cli auth ""` 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
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.
```
[releases]: https://github.com/smbl64/humble-cli/releases
[hb-site]: https://www.humblebundle.com/
[guide-chrome]: https://github.com/smbl64/humble-cli/blob/master/docs/session-key-chrome.md
[guide-firefox]: https://github.com/smbl64/humble-cli/blob/master/docs/session-key-firefox.md
[guide-safari]: https://github.com/smbl64/humble-cli/blob/master/docs/session-key-safari.md