Open-source project
kovidgoyal/calibre avatar
kovidgoyal/calibre

calibre: The GPL-3.0 Ebook Manager for Viewing, Converting, Editing and Cataloging

The official source code repository for the calibre ebook manager.

26,428 stars2,756 forksPythonGPL-3.0

At a glance

What is it?
kovidgoyal/calibre is the official source for the cross-platform ebook manager. It converts, edits, catalogs, and syncs books, but its all-in-one design and Python base bring real trade-offs.
Who is it for?
Adopt calibre if you manage a large, mixed-format ebook library on Linux, Windows, or macOS and need conversion, editing, metadata fetching, and device sync in one tool. Skip it if you want a lightweight, format-specific converter or a cloud-native catalog, or if GPL-3.0 licensing for embedded use is a problem.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository last received commits 1 day ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 13, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • kovidgoyal/calibre26,428 ★ · +969
Star history
Repository2026-07-282026-11-13
kovidgoyal/calibre25.5k26.4k

969 Stars in the last 108 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

The Problem calibre Solves: Ebook Chaos

Most people accumulate ebooks in different formats: EPUB, MOBI, PDF, AZW3, and others. Each format behaves differently on different readers. Calibre exists to impose order on that chaos. It views, converts, edits, and catalogs ebooks in all major formats. It also talks to ebook reader devices, fetches metadata from the internet, and downloads newspapers for offline reading. The intended user is someone with a large, heterogeneous library who wants one tool to manage it all. That is a broad audience, from casual readers to power users who maintain thousands of volumes. The project has been running for years, with a steady release cadence. The recent releases, v9.15.0 through v9.17.0, came out within weeks of each other, indicating active maintenance.

How calibre Works: One Codebase, Many Functions

Calibre is not a single-purpose utility. It is a suite bundled into one Python application. The README lists its jobs as viewing, converting, editing and cataloguing e-books, talking to e-book reader devices, fetching metadata from the internet, and downloading newspapers to convert into e-books. This architecture means every feature shares the same Python core, which simplifies distribution but also creates a large, interdependent codebase.

Getting calibre Running: Commands and Config

The README points to the User Manual for usage and to a dedicated development setup page. For end users, the typical installation is via platform-specific binaries. The source code is available as a tarball from calibre-ebook.com/dist/src. For developers, the manual's develop.html page explains how to set up a development environment. The repository includes a bypy/README.rst file with build instructions for creating binaries and installers for all supported platforms. On Linux, many distributions package calibre directly, so a package manager install works. On Windows and macOS, the official installers are the common route. If you are building from source, note that pyproject.toml requires Python 3.14 or newer, and setup.py exits with an error on an older interpreter.

A Real Limitation: The Monolithic Design

Calibre's biggest weakness is its size and complexity. Because it bundles a converter, editor, and manager into one Python application, it is heavy. For a simple conversion task, firing up calibre is overkill. There are lighter tools that do one thing well. Also, the codebase is massive, which makes contributions harder for newcomers. The README says bug reports go to Launchpad, not GitHub. That separation can confuse contributors who expect to file issues on the repository. The project is GPL-3.0, which is a strong copyleft license. If you plan to embed calibre code in a proprietary product, that license is a problem. The license implications are clear from the repository metadata, but you should consult a lawyer for specific advice.

Alternatives: Specialized Tools vs. All-in-One

The main alternative is a dedicated, standalone converter. For example, Pandoc can convert between many document formats, including some ebook formats, but it does not handle device sync or metadata fetching. Pandoc uses a different approach: it treats documents as structured text and converts via a universal document model. Another alternative is Sigil, which is an EPUB editor only. Sigil focuses on direct XHTML editing, while calibre's editor is one component among many. If you only need EPUB editing, Sigil is lighter and more specialized. For cataloging alone, a simple database or a cloud service like Goodreads might suffice, but those lack local file management and conversion.

Maintenance and Upgrade Cost

Calibre releases frequently, as seen with three versions in two months. That means regular upgrades are part of the deal. Back up your library before major upgrades. The project is actively maintained; the last push was on 2 November 2026. The source repository is on GitHub, but the bug tracker is on Launchpad. For users, the cost is mostly time spent updating and occasionally adjusting to interface changes. For developers, the codebase is large, and the build process is non-trivial, as the bypy/README.rst implies. The GPL-3.0 license means any derivative work must also be GPL-3.0, which is a legal commitment to keep your code open if you modify and distribute it.

Editorial conclusion

Adopt calibre if you manage a large, mixed-format ebook library on Linux, Windows, or macOS and need conversion, editing, metadata fetching, and device sync in one tool. Skip it if you want a lightweight, format-specific converter or a cloud-native catalog, or if GPL-3.0 licensing for embedded use is a problem. Before adopting, verify the current release's stability on your platform, check the Launchpad bug tracker for unresolved issues affecting your device models, and test the conversion pipeline on a sample of your worst-formatted files.

Frequently asked questions

Is calibre ebook reader free?

The source is available under a version-three-only copyleft licence, and the project asks for donations rather than charging. The readme says the software is the result of the efforts of volunteers from many countries and links a donation page. It also states plainly that bug reports and feature requests belong on a different issue tracker from the code repository.

how to install calibre

The readme points at a source tarball for the current release on the project's own distribution page, hosted separately from the code repository, and at build instructions that live inside the repository as a separate document. The manifest declares a minimum interpreter of 3.14, and the install script refuses to continue on anything older, printing both the required and the detected version.

Does calibre work with Kindle?

The readme says calibre can talk to e-book reader devices, and does not name any particular one. It also says the software can view, convert, edit and catalogue books in all of the major e-book formats, which is the part of the answer that generalises. Device-specific detail is in the user manual, which the readme links.

how to use calibre

The readme is not a tutorial and says so: it points at a user manual on its own domain for usage and at a separate development page for setting up a working environment. What the readme itself lists is the capability set, viewing, converting, editing and cataloguing books, talking to reader devices, fetching metadata over the internet, and downloading newspapers to convert into books.

how to install calibre plugins

The readme does not cover plugins at all. It links a user manual and a development page, and it does not mention a plugin directory or a plugin mechanism, so the installation route for one is not described in the README.

how to use calibre to convert kindle to epub

The readme states that the software can convert books in all of the major e-book formats, which covers this direction, and it names the user manual as the place to read usage. It does not give a command or a step-by-step procedure, and the manual is on a separate domain from the repository.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/kovidgoyal-calibre.svg)](https://hysenlabs.com/projects/kovidgoyal-calibre)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/kovidgoyal-calibre.svg)](https://hysenlabs.com/projects/kovidgoyal-calibre)

Was this useful?