How kovidgoyal/calibre works
calibre is a cross-platform e-book manager. Its main user workflow is to add books to a library, enrich their metadata, convert or edit them, and read them or transfer them to an e-reader. The README also identifies web metadata lookup, newspaper downloads, and device communication as product capabilities. The graph combines those documented stages with sampled GUI, scraper, and shared-runtime modules; unsampled capability links are grounded in the README rather than inferred from implementation details.
Main entry points: __init__.py Desktop GUI · webengine_backend.py Browser backend · core.py Qt bindings · search_engines.py Metadata search
Components 22
User applications
- Desktop GUI
src/calibre/gui2/__init__.py - Book viewer
src/calibre/gui2/viewer - Content server
src/calibre/srv/routes.py
Book workflows
- Book catalog
src/calibre/db - Metadata tools
src/calibre/ebooks/metadata - Format conversion
src/calibre/ebooks/conversion - E-book editing
src/calibre/ebooks/oeb/polish - News downloads
src/calibre/ebooks/conversion
External connections
- Reader devices
src/calibre/devices - Metadata search
src/calibre/ebooks/metadata/sources/search_engines.py - Web sources
- Web scraper
src/calibre/scraper/qt.py - Browser backend
src/calibre/scraper/webengine_backend.py
Shared runtime
- WebEngine bridge
src/calibre/utils/webengine.py - Preferences and config
src/calibre/utils - Localization
src/calibre/utils/localization.py - GUI widgets
src/calibre/gui2/widgets.py - Qt bindings
src/qt/core.py - Output utilities
src/calibre/prints.py
Other components
- Reader
- E-book reader
- Scraped sites
Connections 21
- Reader → Desktop GUI: uses
- Desktop GUI → Book catalog: manages books
- Desktop GUI → Metadata tools: fetches metadata
src/calibre/gui2/__init__.py - Desktop GUI → Format conversion: converts books
- Desktop GUI → E-book editing: edits books
- Desktop GUI → Book viewer: views books
- Desktop GUI → News downloads: downloads news
- Desktop GUI → Reader devices: communicates with
- Metadata search → Web sources: searches
- Desktop GUI → Content server: serves books
- Reader devices → E-book reader: transfers books
- Web scraper → Browser backend: dispatches to
src/calibre/scraper/qt.py - Browser backend → Scraped sites: fetches pages
- Browser backend → WebEngine bridge: uses bridge
src/calibre/scraper/webengine_backend.py - Desktop GUI → GUI widgets: uses widgets
src/calibre/gui2/__init__.py - Desktop GUI → Preferences and config: loads config
src/calibre/gui2/__init__.py - Desktop GUI → Localization: uses translations
src/calibre/gui2/__init__.py - Desktop GUI → Qt bindings: uses Qt
src/calibre/gui2/__init__.py - Browser backend → Qt bindings: uses Qt
src/calibre/scraper/webengine_backend.py - WebEngine bridge → Qt bindings: uses Qt
src/calibre/utils/webengine.py - Metadata search → Output utilities: logs output
src/calibre/ebooks/metadata/sources/search_engines.py