https://github.com/dmarby/humblebundle-ebook-downloader
An easy way to download ebooks from your humblebundle account
https://github.com/dmarby/humblebundle-ebook-downloader
ebooks humblebundle
Last synced: about 2 months ago
JSON representation
An easy way to download ebooks from your humblebundle account
- Host: GitHub
- URL: https://github.com/dmarby/humblebundle-ebook-downloader
- Owner: DMarby
- License: unlicense
- Created: 2014-11-29T21:56:26.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-12-07T17:51:24.000Z (over 2 years ago)
- Last Synced: 2024-04-07T04:20:36.398Z (about 1 year ago)
- Topics: ebooks, humblebundle
- Language: JavaScript
- Homepage:
- Size: 182 KB
- Stars: 225
- Watchers: 8
- Forks: 27
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# humblebundle-ebook-downloader
An easy way to download ebooks from your humblebundle account
## Installation
To run the tool, you can either install NodeJS and use npm to install it, or install Docker and run it as a docker container.
### NPM
To install it via npm, run:
```shell
$ npm install -g humblebundle-ebook-downloader
```
You can now use the tool by running the `humblebundle-ebook-downloader` command.
### Docker
To run the tool via Docker, run:
```shell
docker run -v $(PWD)/download:/download --rm -it dmarby/humblebundle-ebook-downloader -d /download --auth-token "auth_string_here"
```
This will download the books to the `download` folder in your current work directory.
Note that you need to get your auth token from the authentication cookie in your browser after logging in to the humblebundle website (_simpleauth_sess) when using Docker, as the option to interactively log in isn't available.
When using the tool installed via npm, it will launch a browser and let you log in interactively instead.
## Usage
```shell
$ humblebundle-ebook-downloader --help
Usage: humblebundle-ebook-downloader [options]
Options:
-V, --version output the version number
-d, --download-folder Download folder (default: download)
-l, --download-limit Parallel download limit (default: 1)
-f, --format What format to download the ebook in (all, cbz, epub, mobi, pdf, pdf_hd) (default: epub)
--auth-token Optional: If you want to run headless, you can specify your authentication cookie from your browser (_simpleauth_sess)
-a, --all Download all bundles
--debug Enable debug logging
-h, --help output usage information
```
## Contributors
- [J. Longman](https://github.com/jlongman)
- [Johannes Löthberg](https://github.com/kyrias)
- [jaycuse](https://github.com/jaycuse)
## License
See [LICENSE.md](LICENSE.md)