Comixology Theme V2 finally released!

Scott (ScooterPSU) 2 years ago updated by martin harrington 1 week ago 363

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!

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.

can anyone tell how i get the publisher image here ?

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.

Im trying to run your script on windows 10 and i'm not sure anything is

happening. I dont get an error message or anything. I have sectioned off

a small section of my comics to test before i ran it on my whole

librbary as i thought this would be a good test however i cant get any

joy with it. Is it better to post on your github or here for some


I am guessing you mean the Comixology scraping script.
this one: https://github.com/CuddleBear92/Ubooquity-Themes/blob/master/Scripts/comixology-to-ubooquity.py

You can always make an issue if you want too.
You should only need python 3 and a few things you can grab with pip. 

Far from an expert on it myself and the script was made by a friend. 
Running it as i stated as an example run works out well for me over here.
If you are missing anything on python with pip then it should error out on the specific requirement to inform you whats missing. doing a simple pip3 install of that and re-trying it should be fine.

there is a few params with the script for sure like scraping series, skipping publishers or series, setting the delay and setting a destination.

Also of which is atleast loosely noted in the readme.md file in the script folder.

EDIT: please, if you follow up on this. Make an github issue and note what script you are using at a minimum. 

The scraping script which is the main part of the repo does not work with any comic folder you have. but rather just scrape the comixology site for metadata and generate files for the theme.

Thanks for getting back to me, that is the script i was using. I think i was misunderstanding what the script does i wanted to scrape all of my comics to add the missing series.json files to all of my folders. I think i may have to grab the files from your repo and try to dump them into my folders.

Best to browse the repo itself to find what you need atm, the release has just a pure dump of the comixology.com scrape without any cleanup.

All publishers and series are sorted correctly in the repo so it should be easy to find what you need if i have it.

Much of it, esp the publishers are still a work in progress.

Also still need to get the script working for the comixology.eu site as it has some publishers and series the .com site doesn't have.

Series years on the repo as a whole have to be taken with a huge grain of salt cause of the limited data the site had.
I pulls all the years and uses the lowest value in both the metadata and the series directory.
This might be way off cause of the site data. This will have to manually be corrected in the worst case. Do plan to add cvinfo files to each of the series folders too which could be re-used again for another script for those wanting that sort of thing.


Hello! I am experiencing this weird bug, if I add a single directory to my library, then I get this very cool read/bookmark button under each issue 

However, if I add directories to the library separately the button disappears 

It's not big deal as I guess I could merge both my libraries into the same directory, (I have one for comic and other for manga) but I was wondering if there is a setting or config I'm overlooking to fix this problem? thank you! 

I think it happens because it creates a different url for the comic directory 

Oh, this must be why mine doesn't have that neat Bookmark button!  I have separate directories for myself and the kids.

They get Angry Birds, I get Inter-dimensional High School for Intergalactic Space Faring Succubus Vampire Zombie Slayers.

I'll just roll theirs into mine for now. What could go wrong?


Hmm, it shows up in my "New" & "Random" section only. Bummer.

Is there any way to separate collections and single issues in a series? ie two groups the way Comixology does it?

An update. Cool!

Does this Audiobook mod work with mapped drives? I've got my audiobooks on a NAS and mapped in my server. Ubooquity sees the files and the Raw Files section works fine.

But when I map it into settings.js

I get this error.


You just need to add 'Audiobooks' to the Settings file, not the path you have. As the picture above shows, you just need what is after File Browser>.

If the program finds the equivalent path (setting) it treats it as Audiobook module. 

Oooooooh.... Got it. It's working now. Thank yoU!

This update is Sweeeet!  It even still supports the shortcut buttons from the old v1!

Big question though. Why do I have the Bookmarks option and Progress Bar showing up only in the New and Random sections?

No Goodies

Cool Goodies

Ok.  I came back to it after a few weeks and it's suddenly working in all sections. I guess the server needed some time, I dunno.

Now the progress bar and options are showing up.

Hey there!

How to change folder name display setting. At the moment folder names are not wrap'ed, when file names are. See the difference below:

I want folder names to be displayed as file names. I'm ready for code changes :) Thanks in advance!



Drop this into bottom the "rawfiles.css" 


div {
width: 150px;
border: 1px solid #000000;

div.icon {
word-wrap: break-word;


I was wondering if this could be modded to look for the last folder with folder-info,header.jpg,folder.css,folder.jpg in the chain to then show that info for all sub folders minus the last folder containing the comics as that would interfere with the series.json.

So the banner will show on all sub-folders without needing to add it to all of them. 

Another one I was trying to do is change the green read buttons to match the blue that is around the browse button above.

I was hoping to add the series.json and header to the main folder so it will show info about carnage for example.

I know the last two can be done but my coding skills are a few hours of google with trial and error. Maybe someone will take pity on me and point me in the right direction.

The styling stuff is in the comixology.css file in the theme's folder.

The background color of the Browse button is on line 126, but mine was set to black for some reason. So I updated it to the green of the Read buttons to show that it can be changed.  

Those Read buttons start on line 1226. You'll want to comment out, delete, or update line 1229 so the border is either gone or matches your new color and replace the #colorcodes on the next three lines to get a solid color.  

I suggest right clicking the buttons, hitting inspect, and playing with the colors you want in there. This also shows you what line in what file the stuff gets its settings from.

This was the easy one. I'll look at the others later.

K.  I tried looking at it, but that part gets into JS and that stuff's all jumbly mumbly to me.  I think somewhere along line 256 in themeScript.js needs an else and then some stuff to look up a directory or two until it finds a "header.jpg" file, but I'm really not sure.

Thank you I was able to find it and change the colors. Made the hover over a little darker

now to use the series.json and header.html/jpg at the same time. 

I redid the header for publishers and plan on redoing the others as I don't care for the green. I might make some changes, maybe redo the font to be easier to read?

link to the publishers.jpg if anyone wants it https://drive.google.com/drive/folders/1v52aozTFXz5ioSiWMLV4ALIKXlcDMaz5?usp=sharing

I also fixed the marvel header I didn't like the size and it was also blurry to me.

Link to the file https://drive.google.com/drive/folders/12tAviPPjU1ytPxo8s5L9X7xeaD72WF69?usp=sharing

I redid the publisher, story arc. And made a couple for DC events and Marvel Events


I was trying to add the ability to bookmark whole comic series however the bookmark button only appears on series that have the series.json file in the directory. Is there a way around this or do i need to add this for every series?

How do make that series.json file to start with? I see things about a scraper, but can't find it.  :(

If I had the button, then could inspect it and maybe figure out what drives it.

Place this in a txt file and name series.json you can replace the info with what ever series you want.

{"metadata": [ {
"name": "Zatanna’s Search",
"description": "Zatanna attempts to reconnect with her father, Zatara, and seeks the aid of several heroes along the way.",
"year": "1964",
"publisher": "DC Comics",
"players": "Zatanna",
"type": "comicArc" } ] }

Thanks.  I gave it a shot but that button looks like it is created, edited, and pointed to its location based on what exists in that json file. Without it, it doesn't look like the button would work if it did show up.

Good evening everyone!
I've got a weird problem.. 
No matter what folder I'm in, if i open a foder with, let's say, 100 files, the first "page" doesn't have the green buttons.. The second page and the ones on do.
I've noticed that when going on page 2 this lovely marker appears ?index=36 and if set to anything but 0 makes the buttons appears (but obviously skips the first file)

Soo.. is it just me or..?

Also, got a little request here, more like a cry for help, haha!
I need to integrate a little snippet of code in the header, but how? If i try to append it the page just keeps loading forever.
I checked it twice and put it all in one single line but nothing. i don't have much experience with javascript sadly! 

Just wanting to check if the right side "Publisher" link is working for others. Mine is breaking and using the error image in its place.

I have the same error and don’t know how to fix it... 

Anyone know how I could edit out the "Browse" dropdown, and just put the "Comics" and "Audiobooks" buttons directly in the navigation bar? The tiny dropdown is difficult to jab on mobile.

Hello, I just found this theme and I am trying to get it to work.

If I enable it and visit it via IP:Port/Comics it seems to work (though alot of pages take ages to load if at all with a white screen and a black circle on it)

However via a nginx proxy nothing works - reset the theme to normal and it works fine. 

my proxy is set as

location /comics/ {
        proxy_pass http://IP:2202;
        proxy_set_header Host $host;

tried with and without trailing slash

the errors in the console are:

Synchronous XMLHttpRequest on the main thread is deprecated because of its detrimental effects to the end user's experience. For more help <a href="http://xhr.spec.whatwg.org/" class="redactor-autoparser-object">http://xhr.spec.whatwg.org/</a> themeScript.js:1939:1

Uncaught SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data
    <anonymous> <a href="https://URL/comics/theme/themeScript.js:19" class="redactor-autoparser-object">https://URL/comics/theme/themeScript.js:19</a>

any ideas?

What does your Settings.js file look like?

Need to add base IDs for Books and Comics.

Hi thanks it's got values in the comicsbaseid I am not using books so have this disabled

I think I have it mostly working, but when I go to a series page I get the following:

in the unooquity log's it shows as

ERROR com.ubooquity.provider.api.user.b - Could not process bookmark request
java.lang.NumberFormatException: For input string: "comics"
   at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) ~[na:1.8.0_242]
   at java.lang.Long.parseLong(Long.java:589) ~[na:1.8.0_242]
   at java.lang.Long.valueOf(Long.java:803) ~[na:1.8.0_242]
   at com.ubooquity.provider.api.user.b.b(SourceFile:68) [Ubooquity.jar:2.1.2]
   at com.ubooquity.provider.api.user.b.a(SourceFile:44) [Ubooquity.jar:2.1.2]
   at com.ubooquity.d.c.a(SourceFile:142) [Ubooquity.jar:2.1.2]
   at com.ubooquity.d.b.handle(SourceFile:54) [Ubooquity.jar:2.1.2]
   at org.eclipse.jetty.server.handler.HandlerWrapper.handle(HandlerWrapper.java:132) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.handler.ScopedHandler.nextHandle(ScopedHandler.java:190) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.handler.ContextHandler.doHandle(ContextHandler.java:1228) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.handler.ScopedHandler.nextScope(ScopedHandler.java:170) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.handler.ContextHandler.doScope(ContextHandler.java:1130) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.handler.ScopedHandler.handle(ScopedHandler.java:141) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.handler.HandlerCollection.handle(HandlerCollection.java:118) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.handler.HandlerWrapper.handle(HandlerWrapper.java:132) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.Server.handle(Server.java:564) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.HttpChannel.handle(HttpChannel.java:318) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.server.HttpConnection.onFillable(HttpConnection.java:251) [jetty-server-9.4.0.v20161208.jar.1030974151070595656.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.io.AbstractConnection$ReadCallback.succeeded(AbstractConnection.java:279) [jetty-io-9.4.0.v20161208.jar.5425350330766075042.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.io.FillInterest.fillable(FillInterest.java:112) [jetty-io-9.4.0.v20161208.jar.5425350330766075042.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.io.ChannelEndPoint$2.run(ChannelEndPoint.java:124) [jetty-io-9.4.0.v20161208.jar.5425350330766075042.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.util.thread.Invocable.invokePreferred(Invocable.java:122) [jetty-util-9.4.0.v20161208.jar.4626548485020188312.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.util.thread.strategy.ExecutingExecutionStrategy.invoke(ExecutingExecutionStrategy.java:58) [jetty-util-9.4.0.v20161208.jar.4626548485020188312.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.util.thread.strategy.ExecuteProduceConsume.produceConsume(ExecuteProduceConsume.java:201) [jetty-util-9.4.0.v20161208.jar.4626548485020188312.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.util.thread.strategy.ExecuteProduceConsume.run(ExecuteProduceConsume.java:133) [jetty-util-9.4.0.v20161208.jar.4626548485020188312.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:672) [jetty-util-9.4.0.v20161208.jar.4626548485020188312.tmp:9.4.0.v20161208]
   at org.eclipse.jetty.util.thread.QueuedThreadPool$2.run(QueuedThreadPool.java:590) [jetty-util-9.4.0.v20161208.jar.4626548485020188312.tmp:9.4.0.v20161208]
   at java.lang.Thread.run(Thread.java:748) [na:1.8.0_242]

I don't have bookmarks currently enabled any ideas?. 

Anyone able to help?

have you got a series.json file in each of the series directories and a folder.jpg?

Hi, it's been a while and I'm rusty.

Can anyone talk me through, like I'm a child, how to setup Story Arcs


Another Question

Is there anyway to save metadata without altering the cbr/cbz file. Where I get them from, it is demanded that they not be altered in any way

thanks again

Had a bit of a play around. Now have all comics uniform in size. changed the structure to add character BIO inside publisher before the actual issues. Minor tweaks to colours and my own LOGO (half shown)