calibre-web-automated-book-downloader

Overview

This template was replaced by Shelfmark. Please migrate to shelfmark. An intuitive web interface for searching and requesting book downloads, designed to work seamlessly with Calibre-Web-Automated. This project streamlines the process of downloading books and preparing them for integration into your Calibre library. You must have already setup Calibre-Web-Automated for this to work. It is an add-on to it. The docker CloudFlareBypassForScrapping isn't needed anymore and can be remove ✨ Features 🌐 User-friendly web interface for book search and download 🔄 Automated download to your specified ingest folder 🔌 Seamless integration with Calibre-Web-Automated 📖 Support for multiple book formats (epub, mobi, azw3, fb2, djvu, cbz, cbr) 🛡️ Cloudflare bypass capability for reliable downloads 🐳 Docker-based deployment for quick setup Note that PDF are NOT supported at the moment (they do not get ingested by CWA, but if you want to just download them locally, you can add pdf to the SUPPORTED_FORMATS env If you are a donator on AA, you can use your Key in AA_DONATOR_API_KEY to speed up downloads and bypass the wait times. If disabling the cloudflare bypass, you will be using alternative download hosts, such as libgen or z-lib, but they usually have a delay before getting the more recent books and their collection is not as big as aa's. But this setting should work for the majority of books. CLOUDFLARE_PROXY_URL is ignored if USE_CF_BYPASS is set to false

Runtime arguments

Web UI: http://[IP]:[PORT:8084]
Network: bridge
Shell: bash
Privileged: false

Template configuration

AppdataPathrw

Appdata folder

Target: /var/log/cwa-book-downloader
Default: /mnt/user/appdata/calibre-web-automated-book-downloader/
Value: /mnt/user/appdata/calibre-web-automated-book-downloader/

Container External PortVariable

Container external port. Follow FLASK PORT. Default: 8084

Target: PORT
Default: 8084
Value: 8084

FLASK PORTPorttcp

Default: 8084

Target: 8084
Default: 8084
Value: 8084

FLASK_PORTVariable

FLASK port. If you change this, you need to recreate the

Default: 8084
Value: 8084

FLASK_HOSTVariable

Web interface binding. Default: 0.0.0.0

Default: 0.0.0.0
Value: 0.0.0.0

Calibre Web Automated Import FolderPathrw

Mount should align with your Calibre-Web-Automated ingest folder.

Target: /cwa-book-ingest
Default: /mnt/user/calibre_library/import/
Value: /mnt/user/calibre_library/import/

Download dir (host)Variable

Download directory inside the docker. Default: /cwa-book-ingest. If you change this, you must change the path for 'Calibre Web Automated Import Folder'

Target: INGEST_DIR
Default: /cwa-book-ingest
Value: /cwa-book-ingest

USE_CF_BYPASSVariable

Disable CF bypass and use alternative links instead. Default: true

Default: false
Value: false

MAX_RETRYVariable

Maximum download retry attempts. Default: 3

Default: 3
Value: 3

DEFAULT_SLEEPVariable

Retry delay (seconds). Default: 5

Default: 5
Value: 5

MAIN_LOOP_SLEEP_TIMEVariable

Processing loop delay (seconds)

Default: 5
Value: 5

SUPPORTED_FORMATSVariable

Supported book formats. PDF is currently not supported. Default: epub,mobi,azw3,fb2,djvu,cbz,cbr

Default: epub,mobi,azw3,fb2,djvu,cbz,cbr
Value: epub,mobi,azw3,fb2,djvu,cbz,cbr

BOOK_LANGUAGEVariable

Preferred language for books. Default: en

Default: en
Value: en

Calibre-Web's databaseVariable

Used to enable authentication to the web gui using the same user/pass as calibre. Remove to disable authentication. MUST NOT BE EMPTY

Target: CWA_DB_PATH

AA_BASE_URLVariable

Base URL of Annas-Archive (could be changed for a proxy). Default: https://annas-archive.org

Default: https://annas-archive.org
Value: https://annas-archive.org

AA_DONATOR_KEYVariable

Optional Donator key for Anna's Archive fast download API

Use Book TitleVariable

Use book title as filename instead of ID

Target: USE_BOOK_TITLE
Default: false
Value: false

DEBUGVariable

Debug mode toggle. Default: false

Default: false
Value: false

AA Additional URLVariable

Proxy URLs for AA, comma separated. Default empty

Target: AA_ADDITIONAL_URLS

HTTP ProxyVariable

HTTP PRoxy URL

Target: HTTP_PROXY

HTTPS ProxyVariable

HTTPS proxy URL

Target: HTTPS_PROXY

Custom DNSVariable

Custom DNS IP

Target: CUSTOM_DNS

USE DOHVariable

Use DNS over HTTPS

Target: USE_DOH
Default: false
Value: false

Custom ScriptVariable

Path to an executable script that runs after each download before the file is moved to ingest directory

Target: CUSTOM_SCRIPT

UIDVariable

Default: 99
Value: 99

GIDVariable

Default: 100
Value: 100

Log LevelVariable

DEBUG | INFO | WARNING | ERROR | CRITICAL

Target: LOG_LEVEL
Default: info
Value: LOG_LEVEL

LoggingVariable

Enable log file in /var/log/cwa-book-downloader

Target: ENABLE_LOGGING
Default: true
Value: true

Links

Template Support GHCR Project

Details

Repository

ghcr.io/calibrain/calibre-web-automated-book-downloader:latest

Registry

https://ghcr.io/calibrain/calibre-web-automated-book-downloader

Last Updated2026-05-31

First Seen2025-01-07

Run calibre-web-automated-book-downloader on Unraid.

calibre-web-automated-book-downloader is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS