Comixology Theme V2 finally released!

Scott (ScooterPSU) 9 months ago updated by Richard Leonard 4 days ago 297

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!

Hey Scott, I noticed there's no arcBuilder with this interation. Is there any plans to re-release that? I was just trying to start doing the arcBuilder script, and came across your post about the new version of the Comixology theme.

arcBuilder might come back in the future, but it was a pretty hacky setup. It'd really need a rebuild. On top of that, it used to bank on leaving Ubooquity folders visible when empty (since there weren't any comics in them) and that doesn't work so well with newer Ubooquity releases.

Currently this supports George Baker's json.cbr format, he built a tool in a different thread that helps make the correct file but it's still a manual process. You can also make compatible files with the new theme's bookmark page, by clearing your bookmarks, bookmark the issues in the arc manually (you can reorder them with dragging and dropping) and then use the Export JSON button. Eventually I want to add metadata lookup to that process, but for now you'd need to edit the resulting output in a text editor to put in the series name/year/description.

So what about checking if a comic already has the metadata? Mylar automatically imports the metadata into the comic if you set that up, so I'm wondering if maybe a check could be made to offload part of the work since it already exists?

That's what I'm talking about with what I want to add to the process. Just haven't gotten that far yet.

Hi Scott, not sure if you're aware of this but if I use series.json, the 'Bookmark Story Arc' button doesn't work, works fine if I switch to folder-info.html, are you still working on this bit?

Yeah the template bits are getting a full overhaul right now. Thanks for letting me know though, I had no idea.

I just posted a new release, lots of css changes (and new template files for series/arc pages). Since I prefer the Comixology-style story arc pages (larger pic, no buttons), I added a setting to themeScript (useSimpleArcTemplate) that'll make it functionally the same to what's there now. And the button should bookmark correctly now.

1. Just re-downloaded the entire folder. Bookmarks are working fine now, cheers. Is the bookmark button on the storyarcs page supposed to say 'Bookmark Sries' now? previously it was 'Bookmark Story-Arc'.

2. I don't have books enabled but when I click on 'New' and then hover over on 'New' again, there's a drop-down now and an option for books.

  a: when I load/refresh the page, the 'new' button is as expected

  b: When I click the 'new' button, it creates a duplicate 'new' button that has a drop down with an option for books.

3. Minor CSS issue that's been on previous versions of v2, hover over any nav drop-downs, to select an option, the mouse-click has to be on the text, clicking on the blue highlight does nothing, can that be fixed?

4. Tried 'useSimpleArcTemplate', the description font-size it's inheriting/set to 16px, where as Comixology has it set to 14px

On a side-note, I'm trying to enable series function on themeScript.js, what ID do I need to use here? any help setting up series is appreciated.

Series is the book-equivalent to story arcs, so if you don't use books it won't work for you.

Good catch on the css/template stuff, I'll sort that out soon.

And the adding/removing nav stuff is sorta hacky, I'll cut it back to just using Ubooquity settings (it's trying to be more user-specific, and apparently failing).

Oh! I thought the series bit was the equivalent of the Comixology series page.

New release should sort out the css/template/drop-down issues. Good catches all around.

I'm hoping with the next Ubooquity release we can pull things in multiple ways, and then proper comic author/comic series/etc pages can be a thing. This was just to add a bit more functionality to the otherwise neglected Book section.

Edit: except the drop-down links needing to click the text, that I haven't sorted yet.

Edit2: nevermind, that's fixed in the comixology2.zip now too! :)

Yeah you need to set that.

You might want to edit the above, it's got your internet-facing url in it.

Thanks for the quick fixes mate, drop-down links fix from the release page works :)

With the recent fixes, I've noticed books is enabled in all menus now, is that expected with the removal of per user visibility code?

It should be now visible if you have book sharing enabled, removed if you don't. The per-user stuff was causing the issue, so I need to figure a better method for that.

Ah! my bad, although I didn't have anything in the books and files folders, forgot that I had the books and files sharing modules enabled, disabling that fixed it.

My final issue, I still see an extra ''random' option which does the same thing as 'Random Comics', I know when books is enabled that changes to 'Random Books', so with books sharing module disabled, is that supposed to be there?

Nope, not sure what I changed to cause that but it should be sorted now. Hopefully that's the last of it. :)

Yep! that's sorted now, thanks. It wasn't a recent change that caused this issue, it's been there since v2 release.

I have my books set up a different way.

I have on what Comixology is Authors. But at this level I have 

Authors, TV/Movie, Other

So as my Authors is next level, the folder images are displaying not consistent sizing. Anytning  I can do without hacking your code. I suppose I could use overiding CSS at each Author page.

Since I'm only setup for one baseID, it would take some changes to declare multiple Author pages. It's doable though, I can have a look.

But to clarify, that has nothing to do with the sizing of those photos. My css only matches width, rather than doing any cropping. To add something like that you'd be better off adding a folder-info.html in each folder with either some css in it, or linking to a css file locally (src="[[folder]]/whatever.css").

Really though, I would just crop the pictures to the same aspect ratio with a photo editor. :)

New release posted, with George Baker's Audiobook mod integrated! This is enabled by sharing a folder with audiobooks in it in the Raw Files section, then put the name of the share in themeScript.js. This method also opens a lot of opportunities for other custom modules, so we'll see what comes of it.

There has also been a lot of css tweaks (certain things Comixology did started to bug me, so I fixed a lot of spacing issues). I would delete your existing comixology2 folder and replace it with this, just to make sure you get everything.

I just upgraded to the new theme, and I like it quite a bit although I had to clear my cache to get it show up properly. Question, though. Where does the default "Comics" image come from? Right now it's pulling the cover from an issue of Shadowman from the Acclaim publisher, but if that can be tweaked that would be great.

Also, I'm probably an edge case, but it seems like the new jquery version takes a lot longer, and definitely chews up CPU a lot more than the old theme. I've got a lot of comics I'm sharing, and as such if there was a way to cache things so it didn't have to constantly try and read the list, that would probably help speed up the behaviour.

I believe that's pulling the cover from the first issue in the first folder alphabetically. You can override that with a folder.jpg in the root of the folder.

Cool, thanks. What about the other question, which most likely was lost since you replied before I clicked edit?

Ah yeah, sorry too quick on the trigger there.

So I'm thinking that the last big offender is the breadcrumb nav (Comics > blah > blah), since it does a lot of backtracking to figure out where you are in relation to other things (take current page, look at parent and find matching link title, go back one more and do it again).

I'll look at caching an array of page IDs, so it doesn't need to dive to find those.

For the homepage though, that's functionally loading 2-4 pages each time (new/random comics and/or new/random books). The idea of that is to actually show those, so I don't see a way to cache that. You could probably speed things up a bit by disabling the random pages (showRandom in themeSettings).

Also, I'm having a problem where it's constantly trying to load the comics/1/ page, and if I look in my network trace, I see that it's 404ing trying to find theme.js, which doesn't exist in the folder structure. Is there something I'm doing wrong, or is that somewhere else?

theme.js was from the old theme, it's probably trying to be loaded by a folder-info.html in your publisher folder. Since in this version the publisher folder is theme-generated, you should delete that.

OK, yeah, removing folder-info.html made the page load. I see I need to remove folder-info.html or tweak it for each of the publishers, now, since the new layout includes all of the stuff that used to be there.  This is pretty sweet, I like it quite a bit.

There's an example publisher page here that shows all that's needed for publisher pages now. I streamlined it a ton.

Cool, thanks. The only "major" complaint I have is that it goes Comics > comics on the Publishers page, but that might be related to the folder-info.html, though I'm not sure how since I removed the HTML file.

Set the comicsBaseID to whatever your publisher page is (sounds like it's 1) and that'll get overridden with "Publishers". That'll also change the drop-down from Comics to Publishers.

Awesome. How come the Featured Publishers keeps changing sorting on each subsequent force-refresh?

That's a weirdness with asynchronous loading (it appends whatever loads first first, etc), but should be less random once I incorporate caching.

New release caches, and has the byproduct of making Featured Publishers load in intended order.

Browse -> Publishers doesn't include the /1/, it just goes to /comics/. Where can I set that?

Do you have multiple base-shares, or is the only thing shared in comics your "comics" folder? If that's the case, there's a Ubooquity setting to "Bypass single root folder".

Yeah, the only thing shared in Comics is my comics folder. I'll enable the bypass single root folder option.

Hey Scott, because you're including themeScript.js in the git repository, any time someone makes a change they have to either remove their changes, or remove the file to update properly. Think you can exclude it from the list of files that need to be synchronized?

Um... what? I can look at moving settings outside of themeScript, if that's what you're asking. But themeScript is what actually builds the theme, if you don't grab the new one you don't get the changes.

Yeah, I think it's more about moving the settings outside of themeScript, sorry, I was typing slower than I was thinking and left half of it out after I clicked "Post".

Basically, the settings (whether story arcs are available, the base Comic, base Book, etc.) should probably be moved out either to a .cfg or .ini or something so that people like me don't need to continually remove, then re-add the settings each time there's an update.

Yeah, that'll be the next thing I take a look at. I'll have it generate on the first run, but exclude the filename from the git.

Edit: actually I won't be able to generate an external file so I'll just include it in the release zip to cover the less technically-inclined.

I see that the Settings .js file is set as read only. Should not be a biggy, but not everyone will work it out.

Good catch, I'll fix that for the next release.

Not sure why I was overthinking that, grab the settings.js out of the release zip and you'll be all set moving forward.

Awesome, that looks great. Thanks!


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. ;)

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...