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
16 Commits 1 Branch 22 Tags 167 KiB
Python 99.5%
Dockerfile 0.5%
043f53b6dc
Go to file
Eddy Hintze 043f53b6dc Fixed #6. Support filtering by platform
2020-01-19 23:11:35 -05:00
humblebundle_downloader Fixed #6. Support filtering by platform 2020-01-19 23:11:35 -05:00
.gitignore Added ci for releasing new versions to pypi 2020-01-19 09:25:00 -05:00
.gitlab-ci.yml New ci flow 2020-01-19 10:00:40 -05:00
CHANGELOG.md Fixed sso & 2fa cookie gen bug Fixed #3 & #8. Added file type filtering Fixed #2 2020-01-19 22:32:07 -05:00
LICENSE Added LICENSE 2020-01-19 09:28:29 -05:00
README.md Fixed #6. Support filtering by platform 2020-01-19 23:11:35 -05:00
setup.py move version file 2020-01-19 09:43:10 -05:00
tox.ini flake8 clean up 2020-01-19 09:40:41 -05: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

  • downloads new and updated content from your Humble Bundle Library on each run
  • 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 cookie generation script
  • 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, they will be used later to download the files.
There are 2 ways to get your cookies: manual or scripted.

Method 1: Manual

Use this method if you know how to get cookies from your browser after you are logged in.
Once you have your cookies, save them to a text file named hbd-cookies.txt in this format:
hbflash=None;_fbp=fb.1.000000.000000;__ssid=XXXXXXXX;_gat=1;_gid=GA1.2.1111111.11111111;hbreqsec=True;_ga=GA1.2.1111111.111111;_simpleauth_sess=XXXXXXXXXXXXX;csrf_cookie=XXXXXXXXX

Method 2: Scripted

WARNING: This method may not work on all systems!
Requires: Chrome and a desktop-like environment (not headless).

Run the command below to open a chrome window. After you login, the cookies will automatically be saved to a text file and the window will close.
hbd gen-cookies --cookie-file hbd-cookies.txt

2. Downloading your library

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

This directory structure will be used:
Downloaded Library/Bundle Name/Bundle Item.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