Web app for browsing, reading and downloading eBooks stored in a Calibre database. Temporary fork of https://github.com/janeczku/calibre-web
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
cellarspoon 0e5548e90f
feat: support generic oauth2
1 year ago
.github/ISSUE_TEMPLATE Removed technosoft2000 docker container 1 year ago
cps feat: support generic oauth2 1 year ago
test Tie visibility of upload buttons to upload right only 1 year ago
.editorconfig Add eslint file 6 years ago
.eslintrc Update to ES5 standards 6 years ago
.gitattributes Merge branch 'Develop' 4 years ago
.gitignore add python-version to gitignore for managed pyenv compatibility 2 years ago
CONTRIBUTING.md Fixes from testrun 2 years ago
LICENSE Add GPL v3 License 7 years ago
MANIFEST.in Merge branch 'Develop' 4 years ago
README.md Updated readme 1 year ago
SECURITY.md Added cve number for csrf bug 1 year ago
babel.cfg Made kindlegen working on windows (including paths containing umlauts) 6 years ago
cps.py Code cleaning (remove python2) 1 year ago
messages.pot Added missing language bit (fixes #2187) 1 year ago
optional-requirements.txt Update requirements 1 year ago
requirements.txt Update requirements 1 year ago
setup.cfg Update requirements 1 year ago
setup.py Deactivate ldap 4 years ago



Calibre-Web is a web app providing a clean interface for browsing, reading and downloading eBooks using an existing Calibre database.

GitHub License GitHub commit activity GitHub all releases PyPI PyPI - Downloads Discord

This software is a fork of library and licensed under the GPL v3 License.

Main screen


  • Bootstrap 3 HTML5 interface
  • full graphical setup
  • User management with fine-grained per-user permissions
  • Admin interface
  • User Interface in brazilian, czech, dutch, english, finnish, french, german, greek, hungarian, italian, japanese, khmer, polish, russian, simplified and traditional chinese, spanish, swedish, turkish, ukrainian
  • OPDS feed for eBook reader apps
  • Filter and search by titles, authors, tags, series and language
  • Create a custom book collection (shelves)
  • Support for editing eBook metadata and deleting eBooks from Calibre library
  • Support for converting eBooks through Calibre binaries
  • Restrict eBook download to logged-in users
  • Support for public user registration
  • Send eBooks to Kindle devices with the click of a button
  • Sync your Kobo devices through Calibre-Web with your Calibre library
  • Support for reading eBooks directly in the browser (.txt, .epub, .pdf, .cbr, .cbt, .cbz, .djvu)
  • Upload new books in many formats, including audio formats (.mp3, .m4a, .m4b)
  • Support for Calibre Custom Columns
  • Ability to hide content based on categories and Custom Column content per user
  • Self-update capability
  • "Magic Link" login to make it easy to log on eReaders
  • Login via LDAP, google/github oauth and via proxy authentication


  1. Install calibre web via pip with the command pip install calibreweb (Depending on your OS and or distro the command could also be pip3).
  2. Optional features can also be installed via pip, please refer to this page for details
  3. Calibre-Web can be started afterwards by typing cps or python3 -m cps

Manual installation

  1. Install dependencies by running pip3 install --target vendor -r requirements.txt (python3.x). Alternativly set up a python virtual environment.
  2. Execute the command: python3 cps.py (or nohup python3 cps.py - recommended if you want to exit the terminal window)

Issues with Ubuntu: Please note that running the above install command can fail on some versions of Ubuntu, saying "can't combine user with prefix". This is a known bug and can be remedied by using the command pip install --system --target vendor -r requirements.txt instead.

Quick start

Point your browser to http://localhost:8083 or http://localhost:8083/opds for the OPDS catalog Set Location of Calibre database to the path of the folder where your Calibre library (metadata.db) lives, push "submit" button
Optionally a Google Drive can be used to host the calibre library -> Using Google Drive integration Go to Login page

Default admin login:

Username: admin
Password: admin123


python 3.5+

Optionally, to enable on-the-fly conversion from one ebook format to another when using the send-to-kindle feature, or during editing of ebooks metadata:

Download and install the Calibre desktop program for your platform and enter the folder including program name (normally /opt/calibre/ebook-convert, or C:\Program Files\calibre\ebook-convert.exe) in the field "calibre's converter tool" on the setup page.

Download Kepubify tool for your platform and place the binary starting with kepubify in Linux: \opt\kepubify Windows: C:\Program Files\kepubify.

Docker Images

A pre-built Docker image is available in these Docker Hub repository (maintained by the LinuxServer team):

LinuxServer - x64, armhf, aarch64

  • Docker Hub - https://hub.docker.com/r/linuxserver/calibre-web

  • Github - https://github.com/linuxserver/docker-calibre-web

  • Github - (Optional Calibre layer) - https://github.com/linuxserver/docker-calibre-web/tree/calibre

    This image has the option to pull in an extra docker manifest layer to include the Calibre ebook-convert binary. Just include the environmental variable DOCKER_MODS=linuxserver/calibre-web:calibre in your docker run/docker compose file. (x64 only)

    If you do not need this functionality then this can be omitted, keeping the image as lightweight as possible.

    Both the Calibre-Web and Calibre-Mod images are rebuilt automatically on new releases of Calibre-Web and Calibre respectively, and on updates to any included base image packages on a weekly basis if required.

    • The "path to convertertool" should be set to /usr/bin/ebook-convert
    • The "path to unrar" should be set to /usr/bin/unrar


Just reach us out on Discord

For further information, How To's and FAQ please check the Wiki

Contributing to Calibre-Web

Please have a look at our Contributing Guidelines