Citadel: A Calibre-Compatible Ebook Manager That Won't Make You Wait
If you've ever managed a large ebook library in Calibre, you know the feeling. You click something, and then you wait. And wait. Citadel is a new open-source ebook library manager that aims to fix exactly that—keeping your existing Calibre library fully intact while making the whole experience feel dramatically faster.
What It Does
Citadel is an ebook library manager that's backwards compatible with Calibre. That compatibility is the central promise here: Calibre must be able to read any library that Citadel has edited. So you're not locked into a new format or forced to migrate anything—you point Citadel at your existing library and it works with the same files Calibre does.
The app itself is a desktop application built with a Rust backend and a frontend running on Bun. It handles your library management—the metadata, the organization, the files—but deliberately stops short of being an ebook reader or a content editor. When you want to actually read a book, Citadel opens it in your default app rather than trying to be a reading environment itself.
Why It's Cool
The performance goal is stated as a hard requirement, not a nice-to-have. The README says Citadel "must feel much faster than Calibre, and never slower." That's a strong commitment, and it tells you the project is being built with a clear-eyed view of what frustrates people about the incumbent. Performance isn't a feature here—it's the whole point.
Backwards compatibility is treated as a first-class constraint. Rather than asking you to abandon your Calibre setup, Citadel works alongside it. The rule is simple and strict: if Citadel touches your library, Calibre still has to be able to read it. That's a design decision that respects the years of organization you might already have invested in your collection.
The non-goals are refreshingly honest. The README explicitly says Citadel is not an ebook reader and not a content editor. It also admits there won't be 100% feature parity with Calibre—particularly around plugins, and some advanced Calibre features they "likely never build." That kind of scoping is a good sign. Instead of promising everything, the project is focused on doing library management well and being upfront about where it stops.
It's cross-platform and actively built. There are stable builds in Releases and development builds coming out of GitHub Actions. macOS users get a .dmg they can drag to Applications. The project also has a Discord server if you want to follow along or ask questions.
The development setup is straightforward if you want to contribute. You need Bun and rustup, then a couple of commands get you running. There's a full table of lint and format commands split by scope—backend, frontend, or everything—and even a way to run just the frontend without the Rust backend (though you'll see errors since the backend is assumed to exist). Rust versions are pinned deliberately, which keeps builds reproducible.
How to Try It
-
Head to the Releases page and grab a stable build for your platform.
-
On macOS, download the
.dmg, drag Citadel to Applications, and open it. If you're using a development build from GitHub Actions instead, note that it isn't signed—macOS will report it as "damaged." You can fix that by removing the quarantine attribute:
xattr -d com.apple.quarantine /Applications/Citadel.app/
- Point Citadel at your existing Calibre library and see how it feels.
If you want to build it yourself or contribute, you'll need Bun and rustup installed. Then:
bun install
bun run dev
# or just bun dev
To create a production build:
bun install
bun run build
The repo is at github.com/everydaythingssoftware/citadel. If you hit crashes or bugs, the README asks you to report them—which is worth doing, since the project is clearly still finding its footing.
Final Thoughts
Citadel is best suited for people who already have a Calibre library and are tired of waiting on it, but who don't want to risk breaking years of accumulated organization. It's not trying to replace your reader or your editor—just the slow, clunky parts of managing a collection. The honest scoping and the strict backwards-compatibility rule suggest a project that understands its users. If performance is your main gripe with Calibre, this is worth a look.
Follow @githubprojects for more developer tools and open source projects.