janeczku /calibre-web

:books: Web app for browsing, reading and downloading eBooks stored in a Calibre database

★ 18,567⑂ 1,910👁 170⑃ 926● 2,817▤ 27
FluentGPL-3.0Created 2015-08-02
下载:V 0.6.27 - LudmilaV-0.6.27 ↓0.6.272026-08-08
+7
日增长
18,567
stars
1,910
forks
170
watchers
926
prs
2,817
issues
27
releases

README

Calibre-Web

Calibre-Web is a web app that offers a clean and intuitive interface for browsing, reading, and downloading eBooks using a valid Calibre database.


!Commit Activity






Table of Contents (click to expand)

1. About
2. Features
3. Installation
   - Installation via pip (recommended)
   - Quick start
   - Requirements
4. Docker Images
5. Troubleshooting
6. Contributor Recognition
7. Contact
8. Contributing to Calibre-Web



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

!Main screen

 Features

- Modern and responsive Bootstrap 3 HTML5 interface
- Full graphical setup
- Comprehensive user management with fine-grained per-user permissions
- Admin interface
- Multilingual user interface supporting 20+ languages (supported languages)
- OPDS feed for eBook reader apps
- Advanced search and filtering options
- Custom book collection (shelves) creation
- eBook metadata editing and deletion support
- Metadata download from various sources (extensible via plugins)
- eBook conversion through Calibre binaries
- eBook download restriction to logged-in users
- Public user registration support
- Send eBooks to E-Readers with a single click
- Sync Kobo devices with your Calibre library
- In-browser eBook reading support for multiple formats
- Upload new books in various formats, including audio formats
- Calibre Custom Columns support
- Content hiding based on categories and Custom Column content per user
- Self-update capability
- "Magic Link" login for easy access on eReaders
- LDAP, Google/GitHub OAuth, and proxy authentication support

 Installation

 Installation via pip (recommended)

1. Create a virtual environment: It’s essential to isolate your Calibre-Web installation to avoid dependency conflicts. You can create a virtual environment by running:
   
   python3 -m venv calibre-web-env
   
2. Activate the virtual environment:
   
   source calibre-web-env/bin/activate
   
3. Install Calibre-Web: Use pip to install the application:
   
   pip install calibreweb
   
4. Install optional features: For additional functionality, you may need to install optional features. Refer to this page for details on what can be installed.
5. Start Calibre-Web: After installation, you can start the application with:
   
   cps
   

Note: Users of Raspberry Pi OS may encounter installation issues. If you do, try upgrading pip and/or installing cargo as follows:
   
   ./venv/bin/python3 -m pip install --upgrade pip
   sudo apt install cargo
   

 Important Links
- For additional installation examples, check the following:
   - Manual installation
   - Linux Mint installation
   - Cloud Provider setup

 Quick Start

1. Access Calibre-Web: Open your browser and navigate to:
   
   http://localhost:8083
   
   or for the OPDS catalog:
   
   http://localhost:8083/opds
   
2. Log in: Use the default admin credentials:
   - Username: admin
   - Password: admin123
3. Database Setup: If you do not have a Calibre database, download a sam

Top issues

Latest release

V 0.6.27 - Ludmila 0.6.27 2026-08-08
!Attention! For this update nh3 has to be installed !Attention!

New features:
- MOBI files now support metadata extraction on upload
- Reverse proxy login with shared secret header implemented

Bug Fixes:
- Cover path is now selected based on the correct setting instead of the presence of split_path (3527)
- Title sort with "l'" now works correctly in French
- Exclamation marks removed from HTML strings
- Kobo sync behind reverse proxy now works correctly: library_sync URL is rewritten in init response
- Add-to-shelves dropdown menu now renders correctly
- Kobo "Sync to last page 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON