Mirrors/humblebundle-downloader
2
0
Fork 0
mirror of https://github.com/xtream1101/humblebundle-downloader.git synced 2024-11-20 08:49:17 +01:00
Code Issues Packages Projects Releases Wiki Activity
Download you Humble Bundle Library
59 Commits 1 Branch 22 Tags 167 KiB
Python 99.5%
Dockerfile 0.5%
7369da336f
Go to file
Eddy Hintze 7369da336f Ignore ruff cache
2024-07-31 20:13:07 -04:00
humblebundle_downloader formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
tests formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
.gitignore Ignore ruff cache 2024-07-31 20:13:07 -04:00
.gitlab-ci.yml Deprecate the download argument. Fixes #38 2021-05-21 13:17:47 +00:00
.markdownlint.yaml formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
.pre-commit-config.yaml formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
CHANGELOG.md formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
LICENSE Added LICENSE 2020-01-19 09:28:29 -05:00
poetry.lock formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
pyproject.toml formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
README.md formatting change. replaced setuptools with poetry 2024-07-31 19:59:58 -04:00
tox.ini Added tests to run in ci. Updated tests. 2021-05-21 12:55:34 +00:00

README.md

Humble Bundle Downloader

PyPI PyPI

Download all of your content from your Humble Bundle Library!

The first time this runs it may take a while because it will download everything. After that it will only download the content that has been updated or is missing.

Features

  • support for Humble Trove (--trove flag)
  • downloads new and updated content from your Humble Bundle Library on each run (only check for updates if using --update)
  • cli command for easy use (downloading will also work on a headless system)
  • works for SSO and 2FA accounts
  • optional progress bar for each item downloaded (--progress flag)
  • optional filter by file types using an include or exclude list (--include/--exclude flag)
  • optional filter by platform types like video, ebook, etc... (--platform flag)

Install

pip install humblebundle-downloader

Instructions

1. Getting cookies

First thing to do is get your account cookies. This can be done by getting a browser extension that lets you see or export your cookies.

  • Method 1 (recommended)

    • Get the value of the cookie called _simpleauth_sess and pass that value using -s "COOKIE_VALUE"

  • Method 2

    • Export the cookies in the Netscape format using an extension.
      If your exported cookie file is not working, it may be a formatting issue. This can be fixed by running the command curl -b cookies.orig.txt --cookie-jar cookies.txt http://bogus

2. Downloading your library

Use the following command to download your Humble Bundle Library:
hbd --cookie-file cookies.txt --library-path "Downloaded Library" --progress

This directory structure will be used:
Downloaded Library/Purchase Name/Item Name/downloaded_file.ext

Notes

  • Inside your library folder a file named .cache.json is saved and keeps track of the files that have been downloaded. This way running the download command again pointing to the same directory will only download new or updated files.
  • Use --help with all hbd commands to see available options
  • Find supported platforms for the --platform flag by visiting your Humble Bundle Library and look under the Platform dropdown
  • Download select bundles by using the -k or --keys flag. Find these keys by going to your Purchases section, click on a products and there should be a downloads?key=XXXX in the url.