Ubooquity

Ubooquity is a free home server for your comics and ebooks library. It supports many file formats, with a preference for ePUB, CBZ, CBR and PDF files.

Adding shared folders

Since Ubooquity does not run with root access, adding library paths requires editing its config file directly.

Step 1 — Shut down Ubooquity from your box dashboard.

Step 2 — Connect via SSH — see the KiTTY guide if you are on Windows.

Step 3 — Open the Ubooquity config file:

nano ~/.config/ubooquity/preferences.json

Imgur

Step 4 — In the comicsPaths section, add an entry for each directory you want to share. Use the following template:

{
    "pathString" : "",
    "userName" : [ "" ]
}

Imgur

Step 5 — Fill in pathString with the full path to your comics folder, and userName with the Ubooquity username that should have access. Your home folder path is shown on your box dashboard — for example /home/HD/USERNAME/torrents/comics.

Imgur

Step 6 — Save with Ctrl+O and exit with Ctrl+X.

Step 7 — Start Ubooquity from your dashboard. Verify the path appears correctly in the Ubooquity admin panel.

Imgur

Configuring OPDS feed

To access your Ubooquity library from an external app (e.g. a comic reader), first make sure the OPDS option is enabled under Advanced in the Ubooquity settings.

Then configure the external app with the following URL format:

https://USERNAME.APPBOXNAME.bysh.me/ubooquity/opds-comics

or for books:

https://USERNAME.APPBOXNAME.bysh.me/ubooquity/opds-books

There is no need to include a port number.