{"id":22372287,"url":"https://github.com/smbl64/humble-cli","last_synced_at":"2026-01-30T17:01:07.402Z","repository":{"id":48411198,"uuid":"499229843","full_name":"smbl64/humble-cli","owner":"smbl64","description":"📦 The missing CLI for downloading your Humble Bundle purchases","archived":false,"fork":false,"pushed_at":"2025-12-29T17:13:29.000Z","size":3465,"stargazers_count":114,"open_issues_count":4,"forks_count":14,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-01-01T22:18:52.793Z","etag":null,"topics":["cli","downloader","humble-bundle","humblebundle","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smbl64.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2022-06-02T17:32:24.000Z","updated_at":"2025-12-29T17:13:32.000Z","dependencies_parsed_at":"2024-05-18T03:28:16.299Z","dependency_job_id":"82a51a72-8c01-4ef0-95e3-debe1767af3e","html_url":"https://github.com/smbl64/humble-cli","commit_stats":{"total_commits":73,"total_committers":3,"mean_commits":"24.333333333333332","dds":0.0273972602739726,"last_synced_commit":"96ea1e64fd306d087242820eece354734d2e2fe9"},"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"purl":"pkg:github/smbl64/humble-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smbl64%2Fhumble-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smbl64%2Fhumble-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smbl64%2Fhumble-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smbl64%2Fhumble-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smbl64","download_url":"https://codeload.github.com/smbl64/humble-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smbl64%2Fhumble-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28915942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T16:37:38.804Z","status":"ssl_error","status_checked_at":"2026-01-30T16:37:37.878Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","downloader","humble-bundle","humblebundle","rust"],"created_at":"2024-12-04T20:36:21.639Z","updated_at":"2026-01-30T17:01:07.392Z","avatar_url":"https://github.com/smbl64.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# humble-cli\n\nThe missing command-line interface for downloading your Humble Bundle purchases!\n\n## ✨ Features\n- List all your Humble Bundle purchases\n- List entries in a bundle, their file formats, and file size\n- Download items in a bundle separately, and optionally filter them with\n    - file format (e.g., EPUB, PDF)\n    - file size\n- Easily see which of your bundles have unclaimed keys\n- Check your Humble Bundle Choices in current and previous months\n- Search through all your purchases for a specific product\n\n## 🔧 Install\n\n### Option 1: Download Pre-built Binaries\nDownload the binaries from the Releases page. Windows, macOS, and Linux are supported.\n\n### Option 2: Install via Go\n\n```sh\ngo install github.com/smbl64/humble-cli/cmd/humble-cli@latest\n```\n\n### Option 3: Build from Source\n```sh\ngit clone https://github.com/smbl64/humble-cli.git\ncd humble-cli\ngo build -o humble-cli ./cmd/humble-cli\n```\n\n## 🚀 Usage\n\nTo 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 the Humble Bundle API.\n\nSee this guide on how to find the cookie value for your browser: [Chrome][guide-chrome], [Firefox][guide-firefox], [Safari][guide-safari].\n\nUse `humble-cli auth \"\u003cYOUR SESSION KEY\u003e\"` to store the authentication key locally for other subcommands.\n\nAfter that you will have access to the following sub-commands:\n\n```\n$ humble-cli --help\nCommand-line tool to interact with Humble Bundle purchases: list bundles, show details, search products, and download items.\n\nUsage:\n  humble-cli [command]\n\nAvailable Commands:\n  auth          Set the authentication session key\n  bulk-download Download items from multiple bundles\n  completion    Generate shell completions\n  details       Print details of a certain bundle\n  download      Selectively download items from a bundle\n  help          Help about any command\n  list          List all your purchased bundles\n  list-choices  List your current Humble Choices\n  search        Search through all bundle products for keywords\n\nFlags:\n  -h, --help      help for humble-cli\n  -v, --version   version for humble-cli\n\nUse \"humble-cli [command] --help\" for more information about a command.\n```\n\n## 📝 Examples\n\n### List all bundles\n```sh\nhumble-cli list\n```\n\n### List bundles with specific fields (CSV output)\n```sh\nhumble-cli list --field key --field name\n```\n\n### Filter by claimed status\n```sh\nhumble-cli list --claimed no\n```\n\n### Show bundle details\n```sh\nhumble-cli details \u003cBUNDLE-KEY\u003e\n```\n\n### Search for products\n```sh\nhumble-cli search \"civilization\" --mode any\n```\n\n### Download a bundle\n```sh\n# Download specific formats\nhumble-cli download \u003cBUNDLE-KEY\u003e -f pdf -f epub\n\n# Download with size limit\nhumble-cli download \u003cBUNDLE-KEY\u003e -s 100MB\n\n# Download specific items\nhumble-cli download \u003cBUNDLE-KEY\u003e -i 1,3,5-10\n\n# Download torrents only\nhumble-cli download \u003cBUNDLE-KEY\u003e -t\n```\n\n### Bulk download\n```sh\n# Create a file with bundle keys (one per line)\nhumble-cli list --field key \u003e bundles.txt\n\n# Download all bundles\nhumble-cli bulk-download bundles.txt -f pdf\n```\n\n## 🔑 Shell Completion\n\nGenerate shell completions for your preferred shell:\n\n```sh\n# Bash\nsource \u003c(humble-cli completion bash)\n\n# Zsh\nhumble-cli completion zsh \u003e \"${fpath[1]}/_humble-cli\"\n\n# Fish\nhumble-cli completion fish | source\n\n# PowerShell\nhumble-cli completion powershell | Out-String | Invoke-Expression\n```\n\n## 🛠️ Development\n\n### Prerequisites\n- Go 1.21 or later\n\n### Building\n```sh\ngo build -o humble-cli ./cmd/humble-cli\n```\n\n### Running Tests\n```sh\ngo test ./...\n```\n\n[guide-chrome]: https://github.com/smbl64/humble-cli/blob/master/docs/session-key-chrome.md\n[guide-firefox]: https://github.com/smbl64/humble-cli/blob/master/docs/session-key-firefox.md\n[guide-safari]: https://github.com/smbl64/humble-cli/blob/master/docs/session-key-safari.md\n[hb-site]: https://www.humblebundle.com/\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmbl64%2Fhumble-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmbl64%2Fhumble-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmbl64%2Fhumble-cli/lists"}