Ubooquity 2.1.1, minor release

22 september 2017    Release

Ubooquity 2.1.1 is available.

This is a minor release: a few bug fixes and a few very specific features.
To upgrade, just stop Ubooquity and replace the Ubooquity.jar file.


Download Ubooquity

Change log

Bug fixes:

  • fixed a bug preventing bookmark saving on Ubooquity server for PDF files shared in the "books" section
  • fixed log display issue on administration page
  • fixed wrong MIME type for some "folder info" resources

New features:

  • prevent Ubooquity from responding to HTTP CONNECT requests
  • add FictionBook (FB2) ebook format support
  • add Comic Book Info metadata support for CBZ files (with a small variation compared to the specs: Ubooquity expects boolean instead of "YES/NO" in the credits.primary field)



Ubooquity 2.1.0

08 july 2017    Release

Ubooquity 2.1.0 is available.

This is the first 2.x stable version. If you were still using version 1.x, you should now be able to upgrade without taking too big a risk. And in any case, should you need them, previous versions are still available for download.


Download Ubooquity 2.1.0

Change log

(since 2.0.2)

  • Fixed PDF wrong MIME type
  • Added link to the library on the admin page
  • Added public preferences access through user API ( /public-api/preferences )
  • Added option to prevent database removal of unavailable root folders
  • Added limited support for AZW and AZW3 files
  • Added page up/down keyboard shortcut in comics reader
  • Modified the bookmark API to include update date in bookmark

If you upgrade from Ubooquity 1.x, read the 2.0.0 release notes, as they contain important information about database and preferences format changes (in a nutshell, you'll have to reconfigure Ubooquity and rescan your collection).

The documentation has also been updated to reflect 2.x modifications.

Ubooquity 2.0.2 BETA

24 april 2017    Release

Ubooquity 2.0.2 is available.
This version fixes bugs found in 2.0.0 thanks to your messages in the forum.
This version is still considered BETA. Wait for 2.1.0 if you want a stable version.


Download Ubooquity 2.0.2 BETA

Change log

Bug fixes:

  • Fixed crash at startup on platform where JavaFX library is not available
  • Fixed empty, unnecessary page in OPDS feed when total number of items is a multiple of pagination number
  • Fixed unreachable folder info resources
  • Make web server more resilient to invalid keystore
  • Fixed file download from OPDS feeds


  • Add support for custom script in user themes (just add a file named themeScript.js at the root of your theme, it will be included in all pages served by Ubooquity, except for the online reader and admin page)
  • Add option to display metadata title instead of filename


Ubooquity 2.0.0 BETA

14 april 2017    Release

It's been a while (almost a year), but a new version of Ubooquity is available, with a few caveats and important remarks:

  • Due to the deep modifications that have been made, this version is to be considered a BETA, with potentially a few more bugs than usual.
  • Preferences file format and database structure have changed: you will loose your settings and a full rescan of your collection will be required. You might as well install this version in a new directory and keep the previous one (not running at the same time though, or don't use the same ports).
  • This new version has to be configured using the web interface: the previous desktop UI has been almost completely removed, keeping only the bare minmum so that you can launch it without using the command line if you don't want to.
  • Ubooquity now uses two different ports: one for the administration page, the other for your library.
  • The Modern theme is now the default theme.

Now if you feel a bit adventurous, you can download the new version using the link below (the one on the "Download" page is still the last stable 1.10.1 version).
Also, if you post messages about this version on the forum, please mention this is Ubooquity 2.0.0, not 1.10.0, thanks !

Download Ubooquity 2.0.0 BETA

Here is the detailed list of changes.

New features and improvements

  • New internal HTTP server: NanoHTTPD has been replaced by Jetty. This should fix issues related to HTTP headers and connections.
  • Bookmarks synchronisation: bookmarks are now saved on the server. You can start reading a book or a comic on a device and resume your reading on another one. Previous mechanism (saving bookmarks in cookies) can still be activated in the advanced settings.
  • New UI: preferences have to be managed using the new web UI (which is now available on a separate port).
    The desktop UI is now a simple launcher, with a few limited options.

  • Command line options have changed a bit too.

    Type java -jar Ubooquity.jar --help to get a description of the available commands:
    Option                                 Description
    ------                                 -----------
    --adminport <Integer: Admin page port  Specify on which port Ubooquity
      number>                                administration page will be available
    --debug                                Activate debug mode
    --headless                             Prevent Ubooquity from displaying a
                                             desktop user interface
    --help                                 Display command line help
    --host <hostname or IP address>        Specify the hostname or IP address to
                                             which Ubooquity is going to bind
                                             itself to
    --libraryport <Integer: Library port   Specify on which port Ubooquity
      number>                                library will be available
    --remoteadmin                          Allow access to the administration
                                             page from a remote machine
    --workdir <directory path>             Specify the working directory of


  • Unreadable files are now ignored.
  • Empty folders are now completely ignored as well.
  • As mentionned before, the default theme is now "Modern". The legacy black theme will be provided as a stand-alone theme later.
  • Comic metadata improvements. New fields are parsed: publisher, alt series, alt series index. Integration and display is not complete yet, though.
  • Books and comics are now displayed using their file name instead of the title found in the metadata.
  • Exclusion patterns have been simplified; the pattern does not have to match the whole path anymore.

Bug fixes

  • Fixed a bug that prevented the fonts used by the online Epub reader from being properly extracted during Ubooquity startup.
  • Fixed PDF description field set to "null" when metadata is not found.
  • Fixed some PDF and Epub parsing issues.
  • Fixed  bug that prevented the reading of comics with a capitalized extension.
  • Fixed cropped image when displaying comic pages in original size (in the comics online reader)
  • Fixed font selector missing update in book reader
  • Fixed OPDS sorting issue for OPDS client which did not respect the provided entries order
  • And a few other minor ones...


I'll probably publish a few additional 2.0.x versions with bug fixes and small new features.
If you want a more stable version, wait for 2.1.0.