AdamGleave / gutenberg-bulk-downloader

Bulk downloader for free ebooks hosted at Project Gutenberg

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GUTENBERG-BULK-DOWNLOADER

Bulk downloader for free ebooks hosted at Project Gutenberg.

Project Gutenberg has a sort of webservice; the protocol is explained here.

Follow the steps in order to create a local development copy in a Linux/Mac OS machine.

  1. Create a project folder in your workspace

$ mkdir gutenberg-bulk-downloader
$ cd gutenberg-bulk-downloader

We will refer to this folder as repository root.

  1. Clone the reposiotry

$ git clone https://github.com/nimiq/gutenberg-bulk-downloader.git .
  1. Create a virtual environment

You can create virtual environments using Virtualenvwrapper or Virtualenv. I usually use Virtualenvwrapper in development and Virtualenv in production.

3.1. Using Virtualenvwrapper

$ mkvirtualenv gutenberg-bulk-downloader

3.2. Using plain Virtualenv

$ virtualenv ve
  1. Install the requirements

$ pip install -r requirements.txt
  1. Run a download session

$ python manage.py --f pdf --lang en --n 100

Appendix A. Command line parameters

$ python manage.py --help
usage: manage.py [-h]
                 [--file-type {txt,pdf,html,epub.images,epub.noimages,kindle.images,kindle.noimages,mp3}]
                 [--lang LANG] [--n-ebooks N_EBOOKS]

Downloads free ebooks from Project Gutenberg.

optional arguments:
  -h, --help            show this help message and exit
  --file-type {txt,pdf,html,epub.images,epub.noimages,kindle.images,kindle.noimages,mp3}
                        Filter by file types.
  --lang LANG           Ebook language.
  --n-ebooks N_EBOOKS   Number of ebooks to download (default: 100).

E.g. download .txt and .pdf files, English and German language, max 500 files:

$ python manage.py --file-type pdf --file-type txt --lang en --lang de --n-ebooks 500

About

Bulk downloader for free ebooks hosted at Project Gutenberg

License:Apache License 2.0


Languages

Language:Python 100.0%