Your comments

Yes, the folder pictures were found using a very inefficient way that required several database requests. Now everything is done in a single requests, which completely ignores the user settings regarding sorting. 🤦‍♂️

I'll try to fix that !

Here you go: https://vaemendis.net/ubooquity/downloads/Ubooquity-3.0.0.zip

Java 17 (or more recent) is required.

[EDIT]: you'll find the latest version here: http://vaemendis.net/ubooquity/downloads/

The documentation on the new theme system: https://vaemendis.github.io/ubooquity-doc/pages/theme-creation.html

And a description of the data (variables) made available to the theme, by page: https://vaemendis.github.io/ubooquity-doc/pages/theme-variables-reference.html

The variables are very unlikely to change before the release of the beta.
The default theme will (HTML and definitely CSS), as it is an awful mess in its current state.

Let me know if you have any question !

That's the point of the beta version. :)

Binary's ready, I just have to finish the doc which explains how the templating system works.

I'll post it here as soon as it's ready (and write a release post later).

The most visible change is the display of the reading progress on books (by books I mean comics as well). 

But to do it I completely rewrote the way themes are managed. Until now you could only change the style and icons of Ubooquity with a custom theme. With V3, the whole HTML structure can be customized. This means a lot more freedom in the way collections can be displayed.

I also merged the "books" and "comics" parts in the code and the database (having two "chains" meant twice the work each I had to modify something), changed the language I use to develop Ubooquity, and dozens of other minor changes. I will write a full change log for the release. :)

Hi Michael,

Thanks for the kind words. :)

Ubooquity already tries to guess the real type of a file (using its header) when it fails to open the file based on its extension. But only for CBZ and CBR files, as they are the only file types I have ever seen mixed up.

This will be a bit improved in the next version with better CBR detection (as different RAR versions have different headers), and better logs.

As for the duplicates detection, since this is quite easy to add, I'll print a list of duplicate files in the logs after each scan.

It's doable, since the progress tracking already exists in Ubooquity (for the online reader). Bookmarks API could be exposed for 3rd party clients. But for that I would need at least one client developper interested in using it.

Unless there is already some standard protocol or API fort that (I don't know about any, except perhaps the one used by KOReader).

What client apps do you have in mind ?

Hi p0lrb3ar, Ubooquity can only display the cover it finds in the book file, it won't look at external files.

The "folder.jpg" image is just used for folders, it won't work for books. Sorry.

That extra click has been bothering me for about 10 years. :D

Direct download when clicking a cover will be possible in the next version of Ubooquity if you use a theme that works that way (thanks to a new theming system that will allow much more customisation). Such a theme should be quite easy to write, I might even create one as an example of how the new system works.


I'll publish a beta version before the end of the summer.

This is not possible with the current version of Ubooquity

But the next version (Ubooquity 3) will allow full control over the html pages with a new theme system, so you will able to translate the text you want.

I will release a beta version this summer.