Your comments

Hello Wisbit,

I won't go into boring technical details, but Ubooquity does not support symbolic links (it might change in a future version as a side effect of some other modifications I am doing, but it's not certain).

I will have the same need as you in a few years, when I will give access to my children to a subset of my library.

For now I think my strategy will simply be to duplicate the files I want them to see in a dedicated folder. Not an elegant solution, but given the size of hard drives nowadays it won't be a problem.

Hello pbx47,

I would do the following to secure your Ubooquity instance:

  •  Once configured, launch Ubooquity without the --remoteadmin flag. This way no one will be able to modify your configuration remotely. Your worse risk will be someone gaining access to the folders you share, not the whole content of the VPS.
  • Use protection against brute force attacks (e.g. fail2ban)
  • Use a SSL certificate to protect your connections (otherwise your password could be intercepted when using unsecure networks)

Try to launch it with the --headless option.

Ubooquity parses all the files, then you choose the way they are displayed: by folder (following your own structure, or flat).

Thanks. :)


I'm not very good with CSS unfortunately.

My advice would be to look for "reponsive design" and "media query" articles on the net, and start from there.

If you just want to have bigger covers though, there is a setting for that in Ubooquity admin screen (but the covers will be bigger in desktop browsers as well).

The default theme files are embedded in the Ubooquity jar file.

When you create a new them in the administration screen, a copy of the default theme is made in the "theme" folder (with the name you chose), so that you can modify it as you see fit.

See "Create a new theme" on this page:

http://vaemendis.net/ubooquity/static10/themes

This is me forgetting to clean up the Ubooquity statistics database and being on holidays far from my computer when it becomes full.

In detail, Ubooquity regularly checks if a new version is available by calling my server. I count these calls and store the result in a database, so that I can have an approximate count of how many people use Ubooquity.

What you see is the server telling Ubooquity that it failed to use the database.

I made room in the table, you shouldn't see this error anymore.

My aplogies for the issue.

The information you want is not available through an API.

But it is written to the logs each time a scan is done.


So if you can ssh into the server, you should be able to get the number and dates with a bit of bash.

When Ubooquity fails to open an archive (e.g. zip or rar), it checks its type using its file signature (also called "magic bytes") instead of its file extension.

Hence the lines you fins in your logs:

20200529 16:32:28 [Scanner thread] WARN com.ubooquity.f.a - Failed to
read file, checking potential extension mistake (cbz/cbr) for:
/comics/Lucky Luke/Zack Album - Lucky Luke 01-14/Zack Album 03 - Lucky
Luke - und der Großfürst.cbr
20200529 16:32:28 [Scanner thread] INFO com.ubooquity.f.a - File type is ZIP (cbz)

When a file has the wrong extension (in this case, cbr instead of cbz), Ubooquity will retry reading it using its real type.

A cbz file will always be correctly read, whatever its extension may be.

Rar files reading is less reliable: Ubooquity relies on a libreary (Junrar) that sometimes has issues with some rar files (and can't read RAR 5 files in any case). If the library fails to read a rar file there is nothing more I can do.

My advice if you are able and willing to recompress your files: drop the RAR format completely, it has almost no advantage over ZIP and a lot more issues due to its proprietary nature.

You can limit the quantity of memory Ubooquity is allowed to use by using the "Xmx" parameter in the command line.

For instance the following command will launch Ubooquity with a hard limit of 512 MB of RAM:


java -Xmx512m -jar Ubooquity.jar


Now if this quantity is too small, you might sometime saturate it with when performing memory intensive operations.
That’s when you get java.lang.OutOfMemoryError: Java heap space errors.


It's up to you to choose the best compromise for the hardware you use and the operations you perform with Ubooquity (PDF processing can be memory intensive with the current version).