Comixology Theme V2 finally released!

Scott (ScooterPSU) 11 months ago updated by Are Finstad 1 week ago 321

It's been a long time coming, but I've finally got the new version of my theme in a form I feel comfortable to release.

It's a massive overhaul from the last version, with a lot of style/feature upgrades. The top-page navigation is all added via jQuery, so it persists across pages. The below text (Comics > Publishers, etc), if not on a folder-info.htm page, is generated on-the-fly.

is the page with the new theme, an updated PageBuilder if you're using it from the previous theme, and some example series and story arc pages (the story arc example supports George Baker's json.cbr files).

Here is an album of how it currently looks.

I'm linking rather than embedding since I won't be able to edit this post later. I'll keep the Github page updated with new features and the album with new images. My goal is to also use the Github wiki to demonstrate how to configure all the extra features.

All theme settings are saved in the themeScript.js, though it should work fine without changing anything. Enjoy!


New release on the GitHub page should have pretty massive speed improvement. It now caches IDs, so there aren't extra jquery loads to get page names.

Good job mate, definitely notice the speed improvements.


You have any use for these? Fonts match the Comixology logo better and colors directly from official SVG logo of Comixology.
I have them in vectorized svg. Let me know if you want them and where to send them.

Yes please! scooterpsu@gmail.com

Scott: Check your e-mail ;)
Don't hesitate to message if you need help with anything.

I like these, could you please post a version of the 2nd one, with the sub-text 'Comic and ebook server' font size reduced, similar to how it's on Comixology?

elmerfdz: The logo you mention has the same size (maybe even a bit smaller) on the sub text as "an amazon company"-text in the official Comixology. See this comparison.


I see, thanks for looking into that. IMO a lower case 'c' would look better there.

You are right. It looks better this way.

I've got a few more suggestions if you want?

  1. Swap the 'and' for an ampersand.
  2. Slightly reduce the space between the main text and sub-text
  3. And if the goal is to match the comixology logo, right align the the subtext. 

Happy now?

Not changing it any more now...

I'm hoping that Scott can serve up the logo that matches Ubooquity's settings, i. e. show "comic server" if the book module is disabled.

I am :D  thanks.

That's a good idea.


New release with the above feature/logos is posted.

works fine mate, banners switch as expected depending on modules enabled.

Scott, the logo doesn't load on mobile (iPhone). I've checked on two different phones.

I moved the function so it's not waiting to set the logo dynamically, so the new release might improve that. My iPhone didn't have any issue, nor did the XCode iPhone simulator, so I'm not sure if this'll sort your issue.  It's also set in the css, so as a fall back there should be something there. Maybe it doesn't like the svg.

I did manage to trigger an issue with the external settings not loading fast enough, so I might look to improve that. But that's not connected to this.

Tried the latest release, still the same. Thought it might be my reverse proxy but nope! it's the same on local url as well, it worked fine before the banner changes.

New release switches to png, see if that speeds things up. Otherwise what model iphone/version of ios? I can test it in the xcode simulator to see if I can recreate.


The switch back to png fixed it! thanks.

Tested and working on XS Max (12.1.4) and 6S Plus (12.1.4), both of them had issues with the previous svg releases.

How would I go about setting this up in a Docker container?


Well this is just a theme for Ubooquity, probably not the support location for a Ubooquity docker setup.

That being said, I personally use this container https://hub.docker.com/r/linuxserver/ubooquity/ via unraid. Just map the container's /config folder to something external, and then grab my theme from the GitHub release page linked at the top and unzip it to the theme folder in that external location.

Thanks for the quick response! My issue was a didn't setup the file permissions correctly, it all works fine now. Thank you very much!

Just did a new install of the theme, but get no web page, and the following log error repeated 4 times:

20190321 10:28:53 [qtp10330637-176] ERROR com.ubooquity.provider.theme.a - Theme resource not found: settings.js

There is no settings.js file anywhere in the comixology2 folder or anywhere in the zip download from github.

Are there install instructions? (I copied the comixology2 folder from the github zip file to my themes folder and then selected it in the ubooquity settings.) Do I have to do a build or run a makefile somewhere?


The comixology2.zip on the release page contains a settings.js file. The file itself is excluded from the repo so syncing with a git client doesn't overwrite your settings.

Edit: I've updated the Github readme to point this out for future users.

That's working much better now! Looks great! 

Thank you


Uncaught TypeError: Cannot read property 'some' of undefined
at getParent (themeScript.js:1304)
at themeScript.js:518
at HTMLScriptElement.script.onload (themeScript.js:1659)

Could I get some context for what page this is happening in?

My bad, as soon as i press "Comics", the start page loads up fine, but as soon as i go to "http://192.168.X.X:2202/comics/1/" i get that error.


No problem, as soon as I asked I managed to find the right combo of settings to make it happen myself. It was an easy fix, timed with me finishing what I was working on anyways. 

New release should sort it.

When using your new Arc template, it is not pulling through the folder.jpg image.

Works fine in the initial release of the template.

You have to use a series.json file, add the json file to a story arc folder.

Search for "series.json" on this thread, you should find Scott's reply regarding this.

Do you mean template or example? The template in-theme is setup to populate different fields than the old one, if you have a folder-info.html in there just remove it.

In the template, I removed the html with no effect.

I would assume that you rename the Comic Arc.html to folder-info.html?

No what I'm saying is there is no longer a need for a folder-info.html. The template is applied via javascript.

Ok all fine now. Having a Blonde moment. Also recovering from an attack where managed to get an encrypter onto one of my pc's. Nothing major lost, but annoying at the least.

Hint, also gets at One Drive. Just re-upping my Arc builder.

Have to look at Sophos UTM. 

Oh good, was actually just pushing a change that would've re-enabled the cover image on the old folder-info files since I didn't mean to break stuff.

Encrypters are no joke, glad you didn't lose anything major.


New release posted!

Now featuring pagination on script-generated pages. This means json-based story arcs and the bookmarks page now split into multiple pages like normal Ubooquity pages. Read buttons now also use the actual link path, so the in-reader progress bar works properly (no more hardcoded 1000 page).

Hi Scott, nice seeing someone activly developing some parts of ubooquity, i just made a tiny script that determines how many pages a comis has and then checks how far you have read and if you are done it replaces the cover with a green checkbox. 

I saw u had a progress "bar" or something in your theme so it seems like you have a similar plan. 

U interested in the code? 

Jesus, so many spelling errors on my part, hard to type on the phone. 

The code is rough as hell and not totaly completed for all scenario, only made it work with "comics" and serverside page tracking, not the cookie part, would not be that hard tho but i had only an hour before sleep, xD

There is no PM system here it seems, so how would u like to proceed?, github?, mail? 

No worries on spelling, I got the gist. You could email it, scooterpsu@gmail.com. 

Yeah the copied elements from comixology had progress bars that I wanted to eventually hook up in this exact manner. Though I need to fix some styling on a couple implementations.


Perfect, i turned my pc off for the night and im typing from bed but ill send u an email before work tomorrow morning. 


you should have an email now, :)


New update!

Using the Ubooquity bookmark API, progress bars now show on any book you've read beyond page 1. Thanks DarkShadowSwE!

Also some new logos from SwedishGojira, since my PNGs were blurry on high dpi displays.

Great work as usual.



One more detail, it would be nice if you could add : https://github.com/sethchhim/Kuboo as a suggested Android App to access Comics/Books on Ubooquity with OPDS.

It's really nice, and since it was developped with Ubooquity in mind, it works really great (and it's free too). ;)


Meant to say, I added this to the last couple releases. Great idea!

Is there any way to load a page without your Header and footer attaching?

I am pre-loading pages to get the data I want, (Book series referenced from the author page).

Works OK as it builds the list of books found on the page, but leaves behind the Header footer (so I end up with an extra for each page loaded) as after processing remove the cells that were pre-loaded. But if I try to remove the Header/footer, I remove all of them.

That depends on how you're loading the page. If you're using a jQuery load function you could specify to only load the #group element, like I do here.

Or if you just want to remove a single instance, use an instance identifier. $('#footer').remove() would remove both, where $('#footer:eq(0)').remove() would only remove the first instance. Alternately that could be $('#footer').eq(0).remove();

Thanks, was on this track after some research. Just had issues with the append.

What i am doing is mimicking the Author page that is used in


Have almost got it. I prefer to have this layout as makes for easier navigation, and to see what is in each Author's collection in one view.

Does that mean that you are close to have a working mean of browsing by author/series in Ubooquity ??? 

If so i'm so eager to see what it'll bring. Can't wait for it. :)

What I am going for is the look and feel.

So have almost got the individual Author pages similar.

Will look at the Author index page to be similar as well.

Thanx a LOT for the dark themes, it's a blessing to my eyes and personnal taste. xD

Was hoping it would come and i'm really happy.

Great work as usual. ;)

How do you change to the dark variant of the theme, or are you literally replacing the files?

on the bottum at settings theres a drop down menu alled theme variant

Thank you, I would have missed that!

Awesome work on this! I've kinda been sitting on Ubooquity and my collection for a real long time, waiting for the ability to set watched status.. I'm so behind on my reading.. This has inspired me to start cleaning up my collection and get back into things again.. Even considering a new 12" Ipad..

Set things up and I'm loving how it all looks.. Just haven't figured out the progress bars yet.. My photoshop skills are super minimal, but I'm gonna try and fill in some of the missing publisher icons that I have and see what other fanciness I can do.

Nice job on this and thanks for making it available :D

*Edit Hitting 'clear cache' on the top right of the Ubooquity page fixed the progress bars not showing up..

First of all, thank you very much for the theme and the work you put into it.

I'm afraid I have several questions because there are several features I don't get to work. I assume that is because of some rather basic mistakes on my part (missing or misnamed folders and so on); I hope you can help me with some of it.

Is there some sort of walk-thru or tutorial somewhere to help me? 

Among the problems that I have are: 

- I can't get Story-Arcs to work (any attempt to have it accessed results in an Error 500 and I seemingly can't manage to point it towards the right directory or I can't create and place the directory correctly).

- I can't get publishers to show Featured Publishers nor does it grab the icons from any of the folders I tried to insert them into the detail view.

I'm using Windows 7, Chrome browser. My current folder structure is Comics > "publisher name" > "series name" (e.g. Comics > Marvel > Nightcrawler (v.01)), but I can certainly change that as I'm in the middle of re-filing and curating my collection anyway. Ubooquity is in a completely different directory as my folder "Comics" is on an external hard-drive whereas Ubooquity is on the main one in my pc.

Any help would be greatly appreciated.

It sounds like the only things you need to set are comicsBaseID and storyArcID in your settings.js.

Open your Ubooquity page, go to Comics. Whatever number is in the address bar (ie. http://whatever/comics/1/) is the comicsBaseID. Go into whatever folder your story arcs folder, get that number and set that to storyArcID.

In my case, my comics folder is 1, so mine is set to this:

var comicsBaseID=1;

And my story arc folder is 200227, so:

var storyArcID=200227;

The theme pulls the images from the folder image of the publishers page, so without that set you get the default image.

See if that sorts your error 500's too.

Thank you, that solved my problems.

Loving this theme. I have a couple of problems the first one is I'm getting this error when I select <browse><series> from the drop down 


Problem accessing /books/true/. Reason:

    Internal server error: For input string: "true"

Powered by Jetty:// 9.4.0.v20161208


Series isn't a true/false, so setting that to true gives you the above. Any setting that ends in ID is looking for the number corresponding to that folder in Ubooquity.

So in your books folder you need to actually make a folder for them, and copy at least one book into it. Then go to that page in Ubooquity, and whatever number is in the URL (ie. /books/4852/ would be 4852) is the seriesID.

var seriesID = 4852; 

thanks for that will take a look in a while, can you explain to me what the optimum folder structure looks like please. I have recently started to do them with publisher, then series, title


One issue is that we're technically talking about different things. The Series section is essentially Story Arcs, but for books. So you wouldn't use Series in the scenario you just described. Plus it only applies to books, not comics.

I use Mylar to sort my comics, and the default is Comics/Publisher/Series/Issues (ie. Comics/DC/Batman/Batman 001.cbr).

Calibre can be setup to do the same, but I haven't messed around with it much.

got it, now working for story arcs. 

my next issue is, I can't see the publisher banner whatever I do. I can access publishers from the menu

Is the image not loading, but it still says "Publishers" in the navigation, or does it just say "Comics"?

I'm guessing you need to set your comicsBaseID. Same as the instructions from above, go to your Publisher page, whatever number is in the address bar is your comicBaseID. It's usually 1 unless you've redone your collection at some point.

var comicsBaseID = 1;

All sorted, I had a large 5 figure number oddly but working

LOVE this theme!!  I was wondering if there was any way to swap the "Read" and "Download" buttons so "Download" was the default and first option whenever selecting a title?  I have a very underpowered NAS running Ubooquity and would prefer to use it only as a server to download from.  Thanks for all the work you've put into this!

That might take some doing, but I'll see what I can do.

is there a way to show an overlay of the number of comics in each series?


In settings.js, set "showBookCount" to true. It adds the count below the title.

I have that set but can't see any count

it seems it something to do with the grouping. if set to folder, the green bar underneath issues disappears and there is also no way to bookmark an issue. 

There must be an error, that doesn't make any sense otherwise. Open your browser's Developer Tools (Chrome's is Ctrl+Shift+I), click Console and copy-paste anything there.

util.js:63 [Xirvik] Options was retrieved.

folderCover?folderinfo=series.json&_=1556377605390:1 Failed to load resource: the server responded with a status of 404 (Folder info resource not found or access not authorized)

themeScript.js:312 The above 404 just means there is no series.json for this page, it can be ignored. - ScooterPSU

So nothing's wrong there, could you post your settings.js?

did this tell you anything?

Only thing that stands out is your bookBaseID is set to true instead of an actual ID. But that shouldn't impact anything here. Otherwise the Xirvik message in your console output makes me wonder if something is being cached somewhere. It's a real head-scratcher.


spot on, cleared cookies and site data in chrome, book count and green selection dropdown appears. thanks Scott

I feel really stupid but I can't figure out how to get the publisher's image to show up on the detail screen of each comic.  Do I just create a folder called "publishers" in the root folder of this theme and within that put another folder with the name of the publisher and them within that put a folder.jpg image of the publisher?  Sorry for the noob question!

I have my comics sorted with multiple similar series inside a single folder that is it's own share.  I.E.  Transformers > (Multiple Transformers folders such as: "IDW 2003-2018", "IDW 2019-", "Marvel 1984-1991", etc.).  When I try to use a folder.jpg in either the root "Transformers" folder, or each of the sub-folders like "IDW 2003-2018" so I can pick the image it seems to have no effect.  Am I doing something wrong here as well?

Thanks again for all the work you've put into this!  Also, don't feel required to respond to my questions.  Even having this theme working the way it is is more than great!

Scratch everything I just posted!  I redid my entire hierarchy with Comics > (Publishers) > (Series) and voila!  Both publisher images on the comic detail page as well as folder.jpg's working fine!

Would there be any way to get all book thumbnails to show at the same size, they are very randomly sized (as I suppose books are). Comic sizing is very consistent with the odd exception of a double spread issue, is there any way to resolve this

Shy of replacing your covers with something like Calibre, not really. The inconsistent sizing also means there's no consistent way to crop the images programmatically so they don't look bad.

I see, maybe there's a photoshop script I could run. Thanks for the prompt reply

This can be done by playing with the books.css file.

I have done this in the past and it worked OK.

anyone any idea how this can be achieved?

I think, looking at it. Ubooquity is ignoring the cover.jpg created by Calibre and is pulling the images from the epub file. I could use the calibre plugin resize xxxxx to give all the books a common size and then 're-convert' from epub to epub which should inject the cover. It would be easier I suppose if Ubooquity read the cover.jpg though


The problem there is that it's extremely user-specific. You're either stretching or cropping, and neither works 100% for all books.

no but most books are portrait, the aspect ratio could differ slightly. I've not seen a landscape Kindle yet at least :)


Completely solved this, more or less as described above. 

using calibur, import your books

select all, download meta data and covers

select all, resize cover (this is a plugin) I use 300x432px (the ubooquity max i think)

select all, bulk convert, to epub

point your ubooquity server at your calibur database or copy all books to where you normally store your books

clear database in ubooquity

VOILA, all perfectly sized books

Good one. But I find it easier to Save books to my Uboo folder using the save function.

Creates a folder under Author name, with then series and if singles then in Author Root dir.

Nice, I'll start doing that

I have a workaround but it is very labour intensive. would it not be fine to have the option to grab the bottom right corner of a book and 'fit' it into the given shape, which would either be stretched or squashed to a greater or lesser extent? this could sort out double page spreads in comics too?

There are many different ways to trim images into a specific shape. Some involve trimming, others involve stretching/squishing.

There is no one method that works for all images. So instead, in my opinion, it makes more sense to leave the images their given aspect ratio. For instances where a comic cover is a double-page, I find it makes significantly more sense to edit the comic itself.

Tweaking code to suit a specific use-case leads to later needing to add code to handle exceptions, which can be tedious.

Feature Request. when i click on a comic, let's say in the Latest comics section. could there be a way to jump to the whole series section for that comic?

Getting the ID of the series isn't really possible with how Ubooquity handles things. Hopefully that's something we can do with the next version.

I have made some progress on a Fantastic Fiction theme (prefer  plugin) for books.

Use for this theme. 

Still a work in progress. I am working on adding a new tab to my UCC arc creator to create the folder.html used in this plugin

After much consternation, have got a finished result.

Have added Series headers and also clickable titles.

Damn dude, that's badass! I'd love to have a look at that code.

Could not resist plying now that I have things sorted.

So my Ubooquity DB got corrupted, causing Ubooquity to crash on startup. I had to delete it and re-import all of my comics, however now all of my folders have changed. I can fix that for each of the individual publishers, which is a PITA but whatever. The problem I'm running into, however, is that the Featured Publishers still point to the old publisher IDs. How can I go about resetting them so that they point to the new/correct IDs?

Hover over the username in the upper-right and the pop-up menu should have a Clear Cache link.

Thanks, that worked perfectly. I had tried the Ctrl+F5 but it wasn't working for some reason.


Ctrl+F5 doesn't necessarily clear local storage, that's why I added this. :)

hello where i can find the media (header.jpg)

I download my header images from comixology.com, or for publishers that aren't on there I modify something from Google Image search.

making some new publisher logo icons, not all are mine and i'm working my way through

A few things.
I've tried the new "settings.json" to activate the display of number of files in a directory, and it doesn't work (after restarting Ubooquity multiple times).

Any idea what could be the problem ?

On another note, could it be possible to make slight change to how things are displayed ?

I would love to see a "separation" between folders and files.

Something like :

Folder1 Folder2 Folder3 


File1 File2 File3

So it's easier to spot/follow.

I must admit with my books i've got a lot of folders and files in the same directories, and it's not really that easy to spot.

And anyone that could write a quick tutorial explaining how to use the Story Arc/Series functions, and the publishers/Authors pages ?

I can't figure that out at all. :D

Check if there's any console output (or try clearing your cache). It just not working is really hard to diagnose.

And no, it's not really possible to separate stuff like that. I'm hoping the next Ubooquity might open stuff like that up.

I've cleared the cache, didn't change a thing (server side and client side).

Ah too bad it's not possible to do that currently, i would love that feature. :)

Will try to check for a console output (now i'll need to figure out where the fuck i can get that in my dockerized ubooquity :p).

Ok well then is there any error in the console? That's the more important bit.

Be sure to reply to the comment, rather than the thread. Otherwise anyone following is getting notified of these too.

Yeah sorry forgot about that. 
Too long since i last posted there, already forgot that simple thing... :/

Console. Ctrl+Shift+I in Chrome. Are there errors in it? I can't help a problem I can't see.

Yeah found it too.
Nope no error.
The only one in there is about a 404 that is because there is no series defined (wich is normal since i didn't use that feature yet).

No other error, and yet still not displaying the number of books inside a folder.

I take it publisher icons go in each seperate publisher folder as a folder.jpg. 

What is the arborecense to respect?

It's that one ? comics / publisher / marvel dc comics ..

but if we also have manga and comic strips how do we do it?

I also classify marvel kiosks by year of publication, how to find them in series?

i have all the tag done with comicrack

is there/could there be a way to bookmark series as well as individual comics?


i have done my scan with ubooquity.

my folder is : comics/publisher (dc comics, marvel,image)

but with the folder.css and folder.html i have this : 

what i have forgot ?

If you have a folder.css and folder.html in your publisher folder (from the last theme), remove that. It's not used anymore.

ok i have delete folder.css and folder.html :

but i don't have tho logo publisher and the featured ? how i can to that ?

The number from the page URL "ie would be 1" is your comicsBaseID. Open settings.js and set that to the appropriate number.

here is mys base for publishers : ubooquity/comics/16808/

where i put in settings.js ? 

You set comicsBaseID to true. It's not a true/false, you should set that to 16808. No quotes, just:

var comicsBaseID = 16808;

The featuredPublishers setting shouldn't be true either. That should be an array, like it was originally set. You would then put the list of publishers you want in there instead of what was there. 

un grand merci deja

big thanks , i have the logo publishers :)

I did not understand how to have the editor in feature, sorry. in any case thank you

Change featuredPublishers back to the way it was:

var featuredPublishers=["DC Comics","Marvel","Image","IDW Publishing","Dark Horse Comics", "Vertigo"]; /* set to null to disable Featured publisher list */

Then just edit the list.

... again thanks u

it's work.

the file serie.json is required in each folder, or can it be activated in the settings?
and how to have the logo of the editor on the right, or should you put the .jpg?

because if I do not put the file serie.json the interface looks like this:

The series.json needs to be in the folder, there is no setting.

The logo is the folder.jpg from the folder containing it. Your Viz folder's folder.jpg. If it's not loading, maybe it's a capitalization issue.

nop it's not loading with chrome with localhost.

but with chrome on my smartphone it's ok ? any idea ?

What about an option to disable series.json queries? I don't have any, so these queries are a waste of resources. And it fills my log with "Folder info resource not found or access not authorized".


Yeah I can roll that into the next release

To get back at you after test on the fact that the number of issues/books didn't appear after activation, it's a bit more complicated.

Be it Comics or Books, it does appear... but only once i reach the 2nd page of entries, whatever number of entries i have per page.

ie : if i put like 1 entry per page, the 2nd entry and all the others will display the number of issues/books in the folder under the title.

If i put 80 it's the same, only 81 and onward (ie page 2 and onward) will display it.

And i've checked there is no error in the console either.

If that can help you pinpoint the problem.


Try the latest themeScript on the Github page (not in releases) here. It might be related to Alpe's issue, I just haven't rolled the fix into a proper release yet.

I'll try that once i get back home and let you know.

Thanx a lot again for the work and the responsiveness (or however that damn word is spelled :x).

Tried the latest ThemeScript.js you linked.

Now i'm back to not having the number of issues/books anywhere at all. 

Still no errors in the console.

edit : ok my bad, for some reason, the settings were changed back to default without reason.
Once i activated the settings again, it's working properly and i've got the issues/books number everywhere.

Thanx for the quick fix as usual :)

hi how to add a section "kiosk" to classify the magazine marvel output by month / year.

the same thing as storyArcID but in kiosqueID?

can't tell you how excited i am to see this update! 

I am, however, having some issues getting going. I have the loading circle issue. I have followed all the suggestions from the above posts, with no luck.

I have installed the zip from the release page on git with no luck, even though you said you had added the themescript.js i still tried adding the linked one, still no luck. I saw a post that the folder-info.html could cause issues, so i have removed them, still no luck.

This is all i'm getting from the chrome console

Uncaught SyntaxError: Unexpected token < in JSON at position 0
at JSON.parse ()
at themeScript.js:19
(anonymous) @ themeScript.js:19 

any thoughts?

Ok, so it's working now (kind of) i think i was just being impatient and needed to clear my cache.

Its now loading the theme sometimes, when it does it doesn't load any comics and then sometimes it just give a blank white page (no spinning wheel). 

The console error its spitting out is:

jquery-3.3.1.min.js:2 GET http://*******:****/comics/?latest=true&_=1558922052136 500 (Internal server error: null)
send @ jquery-3.3.1.min.js:2
ajax @ jquery-3.3.1.min.js:2
w.fn.load @ jquery-3.3.1.min.js:2
(anonymous) @ themeScript.js:78
script.onload @ themeScript.js:1970
load (async)
loadScript @ themeScript.js:1969
(anonymous) @ themeScript.js:50
script.onload @ themeScript.js:1970
load (async)
loadScript @ themeScript.js:1969
(anonymous) @ themeScript.js:49

then a whole heap of these, each one for a different comic by the looks of it:

Invincible%20074%20%282010%29.cbz:1 GET http://*******:****/comics/434/Invincible%20074%20%282010%29.cbz?cover=true 500 (Internal server error: null)

Image (async)
xe @ jquery-3.3.1.min.js:2
Re @ jquery-3.3.1.min.js:2
append @ jquery-3.3.1.min.js:2
(anonymous) @ jquery-3.3.1.min.js:2
u @ jquery-3.3.1.min.js:2
fireWith @ jquery-3.3.1.min.js:2
k @ jquery-3.3.1.min.js:2
(anonymous) @ jquery-3.3.1.min.js:2
load (async)
send @ jquery-3.3.1.min.js:2
ajax @ jquery-3.3.1.min.js:2
w.fn.load @ jquery-3.3.1.min.js:2
(anonymous) @ themeScript.js:87
(anonymous) @ jquery-3.3.1.min.js:2
each @ jquery-3.3.1.min.js:2
each @ jquery-3.3.1.min.js:2
(anonymous) @ jquery-3.3.1.min.js:2
u @ jquery-3.3.1.min.js:2
fireWith @ jquery-3.3.1.min.js:2
k @ jquery-3.3.1.min.js:2
(anonymous) @ jquery-3.3.1.min.js:2
load (async)
send @ jquery-3.3.1.min.js:2
ajax @ jquery-3.3.1.min.js:2
w.fn.load @ jquery-3.3.1.min.js:2
(anonymous) @ themeScript.js:78
script.onload @ themeScript.js:1970
load (async)
loadScript @ themeScript.js:1969
(anonymous) @ themeScript.js:50
script.onload @ themeScript.js:1970
load (async)
loadScript @ themeScript.js:1969
(anonymous) @ themeScript.js:49

Ignore these issues. I did a fresh install of ubooquity and the theme and its all working perfectly now! There must have been something i've done to ubooquity in the past (while tinkering around) that was causing the issue!

Is there anyway to add another section for New Issues or New Releases, similar to the way story arcs is setup. I use Mylar for my library management and it has an option to make a copy of new comics for that week and put them in a new folder, mine is Comics>New Issues>2019-21 for this week. It currently shows up in my normal comic library which is ok, but after playing around with the new theme it would be so good to have it in browse nav bar and quick links?   

I've got another issue but i'm not sure if this is something you can fix. The issue numbering is a little out of wack. For example, Action Comics 2016 has issues ranging from the 900's to the 1000's however it's showing the 1000's first (obviously because its a 1). Is this something you can fix or is this an Ubooquity in general issue. I've tried looking to Mylar to add an extra 0 in front of the 900 series but i couldn't see how and i don't really want to do that to my whole library (nearly 30k comics).

Please, how do I make the icons of the publishers be seen in the description of the comics?
Thank you

THanks for the hard job Scot. This theme is excelsior.

ahhhhhh I can't believe I only saw this now! Amazing work Scott!!

When logging in as everything is fine, but when I come from the outside, I get a spinning throbber and errors in the console. Thoughts?

Ah I think I know why; I set the audiobook share as /Audiobooks/ and it doesn't like it. Let me see what the usage pattern is here...

Got it. needs "", derp.

Any way to hide the "Files" in the top nav since the only thing there is AudioBooks and now it's blank?


I like this theme a lot, thanks for the effort.

I would like to make a change to the "browse->books->library" so that it shows the books directly instead of authors. Is this possible? I go for the book not for the authors when  browsing books,a nd this makes it hard to browse my books if you will.


what is the 'Expected' directory structure for this wonderful Theme?

I have a 'deskful' of little servers (raspberry pi, seagate goflex home, goflex net, a few older laptops, etc) all told.. about a gazillion gigglebits of storage across 7 or so mount points...(linux on everything! That serves).. and tablets/phablets/phones/netbooks to read

I've defined $UBOO-ROOT as 'the place' where everything will 'hang' (books, comics, files, etc)

So... I'll let calibre-server do the initial book server stuff and hang it as 


Files will be whatever as


And then ubooquity top level as


Now, how 'best' to proceed?








Under Publishers we could put the standard 'Marvel' 'DC'

Favorites we'll put Conan, Sandman, and Grendel

Series, and arcs are either virtual constructs or duplicated/possibly retitled books

Misc... well it just don't fit quite right elsewhere..(Power Factor, or Hero Alliance, or Elementals)

Unsorted is the temp holding tank for things awaiting comictagger to add to them, or whatever

And Projects might have collections of Weekly upload 'bundles' or books/publishers organized by time...

Thought experiments aside, what structure does 'Ubooquity' look for (if any), and them what about Comicology2-Theme?

Is there a view somewhere that shows the Path/Location of a given file?

I sometimes find when searching in Ubooquity duplicate/triplicate books i wasnt expecting and it becomes difficult to find them (especially if book filename is wonkie)

And could jQuery be used to generate a webpage of only 'broken books'.... archives that cant be read...(and should be replaced)

I have all sorts of bash/shell scripts that do most of the management.. but it might be nicer to 'theme' it or somehow integrate it...


I am having a hard time figuring out how to have more than one story arc. I export a json from my bookmarks and that makes one. If I want to add a second, do I add the text into the original json? When I do, it just spins. I feel I am missing something very obvious.

I feel pretty dumb. How do I actually install this theme? I downloaded comixology2.zip from GitHub, dropped it in the themes directory of my installation, extracted that directory, and selected it as my theme in the Admin interface. I've restarted my server multiple times and have tried accessing my server in an Incognito Window to make sure nothing is cached, but have yet to see the theme actually activate. I feel like I'm missing a step somewhere. Any help would be appreciated

And it turns out it's not just your theme. Themes in general don't seem to work for me. I wonder if it's related to my Nginx setup or something else I've done in the past.

before we sink our teeth into the complicated... what other themes do you have, and where are they?

better yet, how are you starting up ubooquity?

which OS? (I’ve used Nginx in the past... and had no probs).... so.... introduce us to your machine, and give us some history, please!


I have the basic Modern theme that was included (I believe), and I tried the Plex theme last night as well

Ubooquity is started up with an init.d script, the same one that is found in the documentation. The command it runs boils down to
nohup java $MEM_OPT -jar Ubooquity.jar --libraryport $UBOOQUITY_PORT --adminport $ADMIN_PORT --remoteadmin --headless </dev/null &>ubooquity.log &

OS is Ubuntu 18.04.3 LTS

My Nginx setup is what I was most concerned about because it relies on some reverse proxies (I believe). I basically convert comics.my-hostname.com to my-hostname.com:my-port and comics.my-hostname.com/admin to my-hostname.com:my-admin-port

When changing themes, I do see the change reflected in the preferences.json file.

Turns out it was somewhat a false alarm. I let the server sit for a day or two and then the theme started working on its own. Not sure what would have prevented it before, or why changes to my theme setting need to sit overnight before taking effect, but I now have your theme working wonderfully

this thing is awesome only 2 things arnt "working" for me. 

1. i dont get the folder.jpg to show the publisher logo. (folder.jpg is in the root of the publisher folder)

2. i copied the comicsBaseID from http://IP:2202/comics/9659 and pasted that on the comicsBaseID in the settings.js but when i click on publishers it still show me the comics folder first and when i click that it goes to the publisher page. 

any idea what i'm doing wrong here?


1. Make sure you have "Enable Folder Metadata Display" enabled in the ubooquity settings

2. are you pasting the whole url or just the last set of digits into the settings.js. You should only be pasting the 9659

1 awesome that did the trick ! (Does this also put the image in the comic details page or do I need another image for that ?)

2 I only pasted the 9659 part

1. Awesome!

2. Ok, lets try and figure this out. The 9659 ID you're getting is the the very first page or is it the publishers page? In the Ubooquity settings do you have bypass single root folder enabled?  

Sorry if i'm asking stuff you already know, just trying everything i've done on my end. 


Missed the part about the comics detail page, do you mean the header/banner?

If so then no, you have to source these separate. https://github.com/Telecart/pubthemes has pretty much all of them (at least all the popular ones) as well as Comixology. 

no I mean when you click on a comic and get info/details about the comic you want to read/download under credits their is a image for the publisher I mean that one 

thnx for that url didn’t know that even existed how do I implement this is there a how to somewhere 


There is more here: https://github.com/CuddleBear92/Ubooquity-Themes/

There is a script there to scrape the whole publisher list and all its series from comixology to make these specific files.

I am working on uploading these to the github today and more till im in sync. Clearing out all the old v1 theme stuff i had on it.

People wanting to do it themselfs can easily grab the script and run it in python3. Scraping it all will take atleast a whole day though.

Will be uploading the base scrape first then edit any weird ones that for example have default white backgrounds with black text (so the dark mode themes can still work correct for those).

awesome will check it out

2. When I set base to null. Then I go to browse>comic  then it show me the comic folder Inside that folder are my publishers and that show me that number in de the url. 

When I put I that number on base and then do browse>publishers it still points me to comic folder and when I click that it points me to the publishers page. 

Do you understand what I mean it kind of hard to explain haha 

did a couple of rescans of my library after that this issue was solved :s. my bad :D also figured out that git you send with images.(actually it happens Every time during a scan of the library)

only question i still have is that about the details page when opening a comic on the right i dont get a publisher image.

is there a way to get the menu bigger on mobile phones. when i open the page on my phone it just scales down the website...

Dropped a complete release of the Comixology mirror for this theme in Ubooquity.

Got Logo's and images for all, html and css files for publishers aswell as json files for series.

This first release is just a mirror and uses the names used on the websites itself.
Some year entries might be wrong as the first individual release of the series might have the wrong entry on the site itself.
(site stating the release was 2020 when it was 1995 for example)

Sadly this is reflected in the folder names and the internal jsons.
The script did scrape all years and picked the lowest year number but it didn't help in all cases.

The script itself is also hosted in releases aswell in the repo itself.


Next plans for the next few days:
To upload the missing files in the main repo (that is already in the release).
Clear out old v1 files and keep alternative images.
Clean out white backgrounds with black text to contain the important flag so they are respected by the set theme.

After than i guess i should try to fill out the missing publishers that isnt on Comixology at all.
Don't believe i will replace images with the Comixology Unlimited banner on them, If people have them then please make a pull containing them (or if you make your own).

Notes on the running script, it had some bumps but it was bugfixed.
The last run had a small glip once that didn't repeat itself on the second try.
If the script fails when you run it yourself, please either delete the publisher or series folder in question and try again with the correct skip settings.