Skip to content

Latest commit

 

History

History
118 lines (93 loc) · 6.4 KB

README.md

File metadata and controls

118 lines (93 loc) · 6.4 KB

EbookDownloader

A tool to download purchased e-books from different publishers.

Preview

Table of Contents

Supported Publishers (websites)

Publisher Website Best Quality Selectable Text Hyperrefs Notes
Cornelsen ("New Method") cornelsen.de Lossless PDF ✓ ✓
Cornelsen ("Old Method") cornelsen.de Image (8617px x 11792px) composition ✓ ✗
Cornelsen.CH ebooks.cornelsen.ch Lossless PDF ✓ ✗
Cornelsen scook.de Image (?) composition ✗ ✗
Allango Klett allango.net Lossless PDF ✓ ? [1]
Klett klett.de Image (3072px x 4096px) composition ✓ ✓
Westermann westermann.de Image (2244px x 3071px) composition ✓ ✗
C.C.BUCHNER click-and-study.de Image (1658px x 2211px) composition ✓ ✗
Book2Look book2look.com Lossless PDF ✓ ? [2]
kiosquemag kiosquemag.com Image (?) composition ✗ ✗

[1]: Website allows to download files that are not owned

[2]: No Account needed, only the book id

Automatic Installation

At first, clone or download the repository.

The tool uses image processing libraries and has to be executed with nodejs, therefore some dependencies are required.

You can eiher use the installation scripts (init.bat for Windows, init.sh for Debian based distros) or use manual installation. The installation scripts will download all dependencies for you. To execute them, double click the .bat file on windows or execute the .sh file in the terminal on linux after adding execution permissions to the .sh file.

Manual Installation

At first, clone or download the repository. Then follow the os-specific instructions below:

Windows

  1. Download unifont-15.0.01.ttf from http://www.unifoundry.com/pub/unifont/unifont-15.0.01/font-builds/unifont-15.0.01.ttf and put it in the project root
  2. Install ffmpeg and put the ffmpeg executable (named as ffmpeg) in the project root or add it to your path environment variable, if you need help you can follow this tutorial
  3. Install mutool and put the mutool executable (named as mutool) in the project root or add it to your path environment variable, you can find the most recent builds here. Search for releases with windows. (only required for book2look and cornelsen.ch)
  4. Install nodejs and npm if you haven't already, you can find help here
  5. Run npm install
  6. Optionally install image magick and put the magick executable (named as magick) in the project root or add it to your path environment variable (required only for cornelsen "old method")

Linux

  1. Run wget "http://www.unifoundry.com/pub/unifont/unifont-15.0.01/font-builds/unifont-15.0.01.ttf"
  2. Install packages ffmpeg, nodejs, mutool/mupdf-tools/mupdf (required for book2look and cornelsen.ch) and optionally imagemagick (required only for cornelsen "old method") with your favorite package manager
  3. Run npm install

Linux/Darwin with Nix

  • If you have nix-direnv, run direnv allow to obtain all dependencies
  • Otherwise, run nix-shell.
  • Run wget "http://www.unifoundry.com/pub/unifont/unifont-15.0.01/font-builds/unifont-15.0.01.ttf"

Running

Complete the setup by running npm install in the project directory and start the program by executing npm start from the project directory.

Saving credentials to avoid entering them every time (optional)

You can save your credentials in a config.json file to avoid entering them every time you start the program. To do this, create a file named config.json in the project root and add the following content:

{
    "[PUBLISHER]": {
        "email": "[YOUR_USERNAME_OR_EMAIL]", 
        "passwd": "[YOUR_PASSWORD]"
    },
    "[PUBLISHER]": {
        "email": "[YOUR_USERNAME_OR_EMAIL]", 
        "passwd": "[YOUR_PASSWORD]"
    }
    [...]
}

Replace all the square brackets with your data. Publisher keys are: cornelsen, klett, allango, scook, westermann, clicknstudy, kiosquemag, cornelsench, book2look

Bildungslogin

Cornelsen and Westermann have token-login support, allowing login using Bildungslogin accounts.

Cornelsen

  1. Open Bildungslogin and log in
  2. Go into Storage devtools (SHIFT+F9, or alternatively press CTRL+SHIFT+I and click on Storage tab).
  3. Open the book
  4. Select Local storage in the devtools (possibly also need to select the website in it)
  5. Scroll down in the table that opens until you find id_token. It should be a long alphanumeric string.
  6. Copy it. (Double click, then ctrl+c)
  7. Use it as the password, and use token as the username.

Westermann

  1. Open Bildungslogin and log in
  2. Open the book
  3. Go into Networking devtools (CTRL+SHIFT+E, or alternatively press CTRL+SHIFT+I and click on Network tab).
  4. Tick Persist logs (possibly in Gear menu, likely at top right somewhere)
  5. Reload the page
  6. Enter /api/user into the "Filter URLs" field of devtools
  7. Click the first entry that does not say OPTIONS
  8. A little pane to the side should open. Click on its Headers tab
  9. Enter auth into its "Filter headers" field (if available)
  10. Scroll down until you find a long string of letters and numbers
  11. Copy it and paste it into a text document
  12. Copy it from there again, but make sure NOT to select the "Authorization: Bearer " part, only the long string at the end.
  13. Use it as the password, and use token as the username.

Contributing

Feel free to create issues and pull requests to contribute to the project.

Disclaimer

This project is for educational purposes only. The project is not responsible for any misuse of the software. Depending on your jurisdiction, it may be illegal to use this software to download e-books without the consent of the publisher. In other jurisdictions, it may be legal to download e-books for personal use only. Please check your local laws before using this software.