calibre is the best library manager there is. It does more than any other tool in its category. calibre-zen exists because its interface makes simple things feel hard: buttons that look the same behave differently, and spacing changes from one panel to the next.
So calibre-zen changes how calibre looks without ever editing calibre.
How calibre-zen is built
calibre-zen is calibre with a new interface layer on top. A separate package, the overlay, attaches to calibre when the app starts and wraps calibre’s functions from the outside. calibre’s own code is left alone, so each new calibre release merges in cleanly.
The installer is calibre’s own release binary with the overlay’s Python beside it. Nothing is compiled; Qt and every compiled piece come straight from upstream. The binary you run is the one calibre published.
What’s different
One consistent theme. Every colour, corner radius and bit of spacing is a named token. Buttons, menus, fields and tabs share one padding and one corner. Six colour schemes, with light, dim and dark.
Three widgets replaced. The tag browser becomes a filter panel. The book list gets a preview pane and a Details column. The status bar shows the library, the sort, the content server and running jobs. They read calibre’s own models and database, so no data is copied.
Every part has a switch. Set CALIBRE_ZEN_STYLE=0 and stock calibre comes back. The theme, icons, filter panel, preview and status bar can each be turned off on their own.
When stock calibre is the better pick
- You use plugins that restyle calibre. A plugin that sets its own fonts or colours fights with calibre-zen’s theme. Plugins that don’t touch the look run as they do in calibre; DeDRM, FanFicFare, Export to Markdown and Quality Check are tested.
- You need parts calibre-zen hasn’t reached yet. Some calibre views paint themselves with custom code the theme can’t reach; the bookshelf view is one of them.
- You want a calibre version the day it ships. calibre-zen moves to new calibre versions in its own releases (0.2.0 is on calibre 9.15).
Using both
You don’t have to choose once. calibre-zen’s welcome wizard copies your calibre settings once and leaves calibre exactly as it was. Both apps can open the same library; use it in one app at a time.
