Comixology Theme

KanadaKid (Scott) 3 years ago • updated by Telecart 4 weeks ago 507

After a ton of work, and a lot of hacky css, I think this is ready to share.

Here are some screenshots of the various parts. http://imgur.com/a/3gEcz

And here is the actual theme files. https://goo.gl/eI6EhG

The second link has the theme, the publisher extras, and a readme.txt. Please read before installing.


Is it possible to have the addFeatured only match on the full name, instead of partial matches? My issue is that Marvel is matching against Marvel, Marvel Digital Comics Unlimited, Marvel Knights, Marvel UK, etc.. I'm not familiar enough with javascript to try mucking about with the :contains(+publisher+) in theme.js


That function is pretty basic, only using the "contains" selector which is needlessly vague. I can definitely make that more specific.

Oh, and it appears that FreeBSD has the same sed issue as Mac. For mine, I just changed the OS test to FreeBSD, but you might want to add that to the if statement. The syntax used for mac works perfectly for FreeBSD too :)

What's the FreeBSD response to "uname -s"?

FreeBSD and OSX are basically the same thing, no ?

Darwin is very similar to FreeBSD. But if it was the same thing, the file wouldn't need to be edited... hence the question.

yeah, no of course. response to uname -a should contain "FreeBSD" but I'll let the guy who has it installed and can verify reply :)

Yes, the exact response is 'FreeBSD'


I just uploaded a new version with a custom pseudo selector ":exact" that'll only match exactly what you pass as publisher.

Awesome, that's perfect!

I'm also having trouble finding and using bookmarks. I don't see a submenu under browse, so I'm not sure if any bookmarks have been added. Am I missing something?


You need the folder-info.html and folder.css from StoryArcs.zip, replace the ones in the root of your comics folder.

Got it, but I did have to change the link to the bookmarks.htm file :) This is looking great!


Got the arcBuilder.sh and idGet.sh modified to work on my setup. Will post/share if anyone else has a similar setup with Series in folders by year

/Marvel/Star Wars/v1977

/Marvel/Star Wars/v2015

Scanned for Fall of the Mutants and most series (Uncanny, X-Force, New Mutants) have multiple volumes, so it's working pretty good. Also looks for the exact match now - so it can tell Star Wars apart from Star Wars Darth Vader.

Thanks for all hard work and heavy lifting on this theme and scripts.

very nice! I'd definitely like to see how that came together (and integrate it if you don't mind).


Sure thing. Let me build a few more arcs and see if any issues pop up and then I'll remove some comments/echo statements I'm using for debugging.

Looking for the volume year was pretty easy. Basically you just do another call (bash added for my OSX environment)

#fullSeriesName=`echo $seriesName" ("$start_year")"` #original code           
fullSeriesName=`echo $seriesName`
volumeUID=$(bash idGet.sh "comics/$publisherUID/" "${fullSeriesName}")
seriesUID=$(bash idGet.sh "comics/$volumeUID/" "v$start_year")
echo $fullSeriesName"/v"$start_year
echo $seriesUID

Will post the full files later today


Occasionally I run into issues with comics with long title that disrupt; not sure if other run into this problem

Comic Alignment Broken:

What I found is if you add white-space: nowrap; to comic.css for the .label ... the alignment of the comic is corrected.

Comic Alignment fixed:


I'd thought about doing that a couple times, but I personally prefer to have the full name so I'm not losing issue number.

I had tweaked something a few releases ago that aligned the images, but I lost it in an over-undo. That'll be my next move.

Found my solution, setting #group to align-items: baseline;

I released an update with the fix, or you can try it yourself. Line 77 of comics.css.

I took out the nowrap and textoverflow and added align items, but that didn't seem to help. It really is most noticable on the new items. Looking at your comics above, I'm guessing they are missing the titles in the xml file

Browsing Latest

In the actual series

Yeah, I edited mylar's comictagger scripts to leave titles blank.

As for the alignment, you did the edit to #group and not .label, right? There should've already been an align-items under #group to edit.

I was thinking of doing the same thing to Mylar. What file/line? Can you share that edit?


To remove titles:


line 92:

assign( 'Title', None )

line 222:

md.title = None

To remove alternate cover tables:


line 448:

metadata.comments = self.cleanup_html(issue_results['description'], True)

After the edits, you need to remove the .pyc files (cached python). They get rebuilt next time you run it.

Yep yep, here you can see where I've taken out the change for hiding "long ass titles" hahaha ( Don't get me wrong, I like titles on the pop up, but can't wait for issue numbers from the server

Confirmed Changes : white-space: nowrap; and text-verflow: ellipsis removed from the 450 block

Here you can see the property from group from chrome's inspect element. It appears it has ignored font_family, align items and justify content in the 70s block

Right, but the important one, align-items: baseline, would be just below what's cutoff in your second screenshot. If it's flex-end, that's the problem.

Well I did some more digging and here's something interesting. I want to get an idea of what align-items was doing and moved it up to the label and adding some color. It looks like because of the min and max heigh, the cells are not static and size and are like stretchy pants

Take a look

If we change the min-height to the max height so that we know each box is fixed Tadda .. Now regardless of the title size all text boxes are the same. No more stretchy pants! Also this is what I love about the inspect elements. You can make real time tweaks!

I mean yes, locking that to a specific size does line them all up.

The issue you're having is that align-items: baseline doesn't go in .label, it goes in #group.

Doing this lines the bottom of the covers up, regardless of label-size (which I've upped the max to 64px).

Yeah that was was just tinker with that. If you lake look at my shield now ( with align-items in #group keep in mind chrome still states that's an error not sure why ) and changing the box size we get happy dance!!!

With baseline set, you shouldn't need the matching min-height, max-height. You could also just replace both with just height.

I have min-height: 30px, max-height: 64px. So it can expand to 4 lines, but defaults to 2.

Yeah but I don't want to tinker with the css :-) another question I was browsing the database for ubooquity. Can bookmarks can be stored in the database if you create your own table?

I hadn't gotten far enough to access the database, otherwise I'd be scraping it for comic IDs. I think it should be possible to potentially do that, but javascript database stuff is new to me. If it did work, that'd be pretty slick.

Give it a shot, it's easy to get into the db once you have the H2 server. Just make a backup copy of the DB. You'll see the comic table with the id and there's another table that has the username.

In theory, one would need create a bookmark table with the user id, comic id. Then from there it just read, inserts, and deletes similar to how you're handling cookies .. except it work across devices :-) You'd could also build out story arcs directly in the database. instead of using a csv file :-)

Just two question needs to answered

- Will the server let java scripts write to the DB

- Does the owner plan to keep the H2 DB going forward

Sidenote netstat -ltp and netstat -lup don't show any ways to get into the DB outside of ubooquity :-(

Here's a link to my updated "arcBuilder" and "idGet" files.


Made a few more changes to them. Series with a comma (Firestorm, the Nuclear Man) and series with a period at the end (Infinity, Inc.) would fail. I adjust the searches to account for this. This version of arcBuilder works if your series are split into folders for year using the pattern

/Marvel/Star Wars/v1977

/Marvel/Star Wars/v2015

Just ran through a 75 issue build for Crisis on Infinite Earths with no problems.

Just getting a chance to look at these. The improvements for idGet actually helped with my setup. For Brightest Day, it was pulling Blackest Night Flash (2010) instead of just Flash (2010). So I'm definitely incorporating that change as-is. Nice work!

The arcBuilder stuff I want to add in as an optional thing, or maybe a fallback if it doesn't find otherwise (like have it look for issues, and if it only finds more folders go deeper). That might be the way to go.

Since I was playing around with bookmarks as a method for arc file creation, I realized what it needed the ability to sort. I worked in jquery-ui, using it's sortable() addition. Here's a vid of it in action.


Latest version is posted.

Hi KanadaKid can u give me the psd of the image u use for the theme i want to translate it in french

The only images with text are the sign-in button, and the logo. The button is screen capped from Comixology. Pretty sure "Ubooquity" isn't English.

I actually just uploaded a new copy no longer using the Sign In button image. Now any text I'm setting can be edited in the css/html/js files.

im quite new to ubooquity but till now i got everything up and running including this fantastic theme.

however im having some issues to get the PageBuilder.sh to run.

this is what i'm getting if i run the script

bash-4.3# /config/PageBuilder/PageBuilder.sh /mnt/user/EBooks/comics/Marvel/'New Avengers (2015)'/cvinfo

Downloading comic data

jq: error: Cannot index array with string

jq: error: Cannot index array with string

jq: error: Cannot index array with string

jq: error: Cannot index array with string

Building comic page



Usage: /config/PageBuilder/imageGet.sh -c 'Comic Name' [-d 'Comic Year'] [-r 'Which result to save']


and this is the content of my cvinfo file


Did you set your comicvine api keys?

OK that was missing.

now, by some reason its saying:

bash-4.3# /config/PageBuilder/PageBuilder.sh /mnt/user/EBooks/comics/Marvel/'Age of Ultron (2013)'/cvinfo

Downloading comic data

Building comic page

Comic: Age of Ultron

Date: 2013

Getting series ID

Waiting 10 seconds to look less automated

Trying again without date parameter

Series not found


So the "Series not found" is from imageGet.sh, means it didn't find it on Comixology to grab the appropriate cover.

The page itself should be there now.

yes the page is now there.

what are the search criteria send to Comixology? because i could find the series, however with a different date (2010)


there must be something with my setup, i tried the PageBuilder.sh for al my Marvel Comics with the same result. "Series not Found"

If you did it for a large number of entries, it could also be that you were temp flagged as a bot. The script works by using google to parse out Comixology's id, so too many requests at once throws up flags.

i run it one by one.

any idea what i could test to see where the problem could be?

Try the imageGet.sh I just uploaded, it's on it's own. Open it before you run it and set it to your local google, I'm guessing that's probably what triggered the bot detection in the first place.

This should catch any http errors, and if not solve the problem at least identify it.

OK got it to download the image.

- with google.com: error bot detected

- with local (google.ae) download blocked

- with google.de success

shall i use the new script or better update the original one to use google.de ?

Use the new one, it'll be the official one moving forward. I wanted to make sure that caught the issue before pushing it as an official update.

just got again the "Google bot detection" only after 2 checks.

its strange if i run the google query on another computer on the same network its working. how is google detecting the "bot"?

The theory is that it's because of the really specific searches with weird patterns. But why it triggers quickly for some, and never for others makes no sense. I tried getting around that with the delay setting, but it doesn't seem to make any difference.

i tried to run the scripts now on a different Linux machine (different disto) and its working.

strange thing.

by the way i have the same issue with the __Story arc as "Are Finstad"

if i try to open the link its not doing anything. any idea?


I just posted a new update with a new imageGet in it, I'd recommend switching to that one and setting your google localization.

Make sure you don't have Ubooquity set to hide empty folders, since the arc folders are technically empty.

could you add some more notes on how to use the pagebuilder zip files? running on windows BTW, tried for a while with the bash for ubuntu for windows app but im new to these things. would love for some feedback on how to best run it and how the settings are suppose to be set.

it would also be nice if you could cover how the pagebuilder folders should be placed, like should it be in the theme folder? in the comics folder? does it even matter in the end?

also, i added the story arc folder to my comics folder with the premade ones you gave out. i replaced all files i could from the extras zip but i cannot seem to load the story arcs folder at all either. (it just sends me back to the publishers folder)

I'd have to let someone else handle what it took to get it working on windows, I'm not setup to test that so I'm not sure what was involved. As for documentation in general, a lot of this has been in flux lately, and I just haven't gotten that far yet. I saw your comment on the dropbox file too, didn't even realize that was a thing.

The main settings that need to be set are your comicvine api key in pageBuilder.sh and arcBuilder.sh. You also need to set the folder path to your story arc folder in arcBuilder.sh. The .sh files can all be opened in a text editor, and any settings related to each is at the top, usually also labeled.

PageBuilder is a standalone thing, it doesn't have to be anywhere near the theme files or comics. When you run it, you would do the following:

/path/to/pageBuilder.sh /path/to/comics/publisher/comic/cvinfo

The stuff from the StoryArc.zip needs to go over what was in extras. I need to incorporate those at some point. If you are not using a proxy prefix in Ubooquity, you need to edit theme.js (again, settings at the top, labeled) to match. Also, since Story Arcs are functionally empty folders, you need to change the setting in Ubooquity to not hide empty folders.

Just posted a new PageBuilder. Biggest changes are in imageGet, it no longer guesses at image names. Since I was getting the exact page on Comixology, I figured why not just download it and scrape for the exact image. Now it should catch weird named covers. It also watches for Google page errors (bot detection) and stops rather than trying again. There's also a setting to set your local Google url.

Ok, incorporated the new PageBuilder, and since I'm on FreeBSD, I had to replace jq. I also have to replace pup, but I have no idea where to get it. Is it part of a larger package?

Oh right, I should probably link that somewhere. This is where I pulled it from: https://github.com/ericchiang/pup/releases

Nevermind, I found it :)

Ok, I've been investigating the 302 error, which is happening no matter what localization I use. I replicated the curl statement, plus a few things that may be FreeBSD specific, but they're mostly unrelated... But here's the error I'm getting from that 302:

<HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8">

<H1>302 Moved</H1>

The document has moved

-- Not sure if that's helpful at all, but it's about as far as I can get on my own

You're not going to get anything from the actual 302 page, at that point it's already too late. It's trying to redirect curl to a page with a captcha. In fact, the more you investigate, it may just be keeping the problem alive. Give it some time, it seems to expire after a while.

Hmm, so far, I've not gotten any successful pulls with the new imageGet, but I'll try again tomorrow. :) It's not high on my priority list, but I'd love to see my setup with consistent folder images :)

got finally most up and running. the only thing which is right now missing is the "Story Arc"

i tried the "arcBuilder" however i'm getting only the below error.

apiKey and Cookie are set

bash-4.3# ./arcBuilder.sh -p /mnt/user/EBooks/comics/

./arcBuilder.sh: line 29: idGet.sh: command not found
idGet failed, probably using an invalid cookie

You're blending what you're reading from my posts and mediabot666's. The path to your arc folder should be in arcBuilder.sh, not passed as an argument. The syntax for my arcBuilder is just:

arcBuilder.sh 'name of arc'
Pretty sure this is why his later release was named arcScanner.

If you're trying to use his instead, he'll have to assist. I never personally got it working.

ok, got the idGet issue fixed.

had to update the scripts some "$my_dir" entries were missing.

now i have the following :

bash-4.3# ./arcBuilder.sh 'The Killing Joke'

Publisher:DC Comics


Story Arc ID:40503

Building comic page

./arcBuilder.sh: line 43: [[[: command not found

./arcBuilder.sh: line 43: [: missing `]'

Comic: The Killing Joke

Type: arc

Searching for Comixology page

HTTP Response: 200

Series not found

Generating arclist

5 issues

Batman The Killing Joke (1988)

Batman The Killing Joke 001 1988

DC Universe The Stories of Alan Moore (2006)

DC Universe The Stories of Alan Moore 001 2006

Batman The Killing Joke The Deluxe Edition (2008)

Batman The Killing Joke The Deluxe Edition 001 2008

Booster Gold (2007)

Booster Gold 005 2008

The Brave and the Bold (2007)

The Brave and the Bold 033 2010


how/what is the arcBuilder exactly suppose to do in regards to the "Issues" of an ARC?

is it creating any links to the corresponding series?


So arcBuilder is (or at least should be) using idGet to find the issues for the arc in Ubooquity, and save them into a csv file. The arc page then parses the csv to show the issues.

How are your comics setup, folderwise?

It's hardcoded looking for "Series (Year)" as the series, then looks for filenames containing "Series Issuenumber (Year)". If your comics aren't setup that way, it won't be able to find the issues and you end up with a blank csv.

the folder structure is like this:

/mnt/user/EBooks/comics/DC Comics/Suicide Squad (2016)/

filenames like "Suicide Squad 1 (2016).cbz"

the arclist.csv file is created but empty

ok got it up and running. setup a new VM with a differed Linux distri. and everything seems to be working.

thanks a lot for your help


After helping mediabot666 with some code to load Javascript across all of Ubooquity, I was inspired to finally fix some things that were bothering me about Ubooquity theming. The downside is, this theme needs you to use javascript injection. Because of this, I'm hesitant to release until something like this is supported by Ubooquity natively.

Just to give a good idea of what you're looking at:

  • Bookmarks have been centralized. Since this applies across all of Ubooquity, you can bookmark books too.
  • Home always goes to the homepage, no matter what page you're on. The page headers are better for navigation anyways.
  • New and Browse adjust based on what the user has access to. If you only have comics setup, New is a button, and Browse has "Publishers" and "Story Arcs". If you have just books, New is a button and Browse lists "Authors" (just the base of books, the equivalent of Publishers. If you have both enabled, like I do, New becomes a menu and Browse shows all 3.
  • If you have Files enabled, it shows as it's own button.
  • This new nav bar sticks to the top of the screen if you scroll down, like on Comixology itself.

  • Page controls have been redone. Rather than fighting with css, I went with jquery to move the elements, so they always line up correctly. And the page number always shows, even on searches.
  • There's a persistent footer (which I haven't figured what all to put in yet). Rather than just the current one-liner.
  • The search bar shows on all pages, with an option to set what it searches by default (while navigating books, it'll search books, comics while navigating comics. The setting would control while on the homepage/bookmarks/admin/etc.).

definitely like the flatter look and persistent menubar. Still not managed to get Story Arcs or Bookmarks to work, though I've pretty much stopped trying (diminishing returns...).

Sounds like Tom is prepping to release a new version in 2016, so that can't be much longer and some of these features may become easier to do in the new version, so I understand if you elect to keep it at bay at this point.


Going deeper down this rabbit hole, more and more dependent on javascript-support being added to themes stock. One of the opportunities this opened up was a more useful homepage.

You can set in the theme how many random/new comics to add to the page, it defaults to 30 (it can't be any higher than your comics-per-page setting). It'll load your bookmarks if you have any, or hide the control if you don't.

While this shows Latest Comics/Random Comics, if you have Book-sharing enabled it will also show Latest Books/Random Books.

Cool! How does the random comics work? Does it change on refresh?


The default theme has a random button for comics/books that goes to /comics/?random=true and /books/?random=true respectively. I didn't have any use for this before, so I hid the control.

This is reading the random and latest pages and copying the issues from it (hence not being able to go beyond the comics-per-page setting). And yeah, when you refresh the page it re-queries the random page and gets new results.

I also added a link to the Random page under the Browse drop-down too, since there was space.

Dear Friend,

I need this theme, please upload anywhere :)


For this theme to work, you need to modify your copy of Ubooquity. Because of this, I'm holding off until the next release of Ubooquity.


Possibly, You may know when it will be available?

Nope, the last mention of a release was before the end of 2016. Now that we're past that, your guess is as good as mine.


1) If Javascript injection (by placing a js in the ubooquity.jar) is still necessary, is there a place where I can find documentation on how to accomplish this?

2) If 1 = "Yes and Yes", then can that be added to the Readme?

1) To make what I just posted pics of work, it's currently necessary. It shouldn't be for (hopefully) the next release of Ubooquity. Because of this I'm holding off on releasing it until then.

2) If it isn't part of the next Ubooquity release, the necessary readme will accompany the release of this new theme version.

Much appreciated. I've looked around these forums but haven't seen word on when the next release is slated other than "hopefully before the end of 2016." Is that still the case, or do you have an inside scoop?

Also? Thanks for all your hard work on this. It's pretty darn amazing.


Your guess is as good as mine. I'm hoping Tom is still on track, but that's just me being optimistic.

You're welcome! I'm glad there's this much interest in something I just threw together because I wanted it. :)

Because I have a mac server, and because I'm a crazy person when it comes to my org structure for comics, I've been doing the CSVs for the story arcs by hand (I find it strangely relaxing).

To that end, I noticed how comixology's website included links to entire volumes for their "Rebirth" story arc. I decided to see if the CSV could support the same feature and found it surprisingly easy to do. Just change the javascript to resemble the following:

"/ubooquity/comics/61578/","showHidePopupMenu();return true;","/ubooquity/comics/61578/?cover=true","Superwoman (2016)"

I'm having a small issue at the moment with the arcbuilder. When i try and run it for Civil War II it creates an arc for Road to Civil War II. Comic Vine has Civil War II in the Arcs section but the arcbuilder isn't finding it. Any ideas? Any way to be able to put the comic vine numbers directly in instead of the Arc Title? (eg 4045-58879)

I'm loving the theme, however I have my reverse proxy setup to be /comics. I'd really rather not have to change the redirect and have to go about updating all the places where I've got it set, so which file has it pointed to /ubooquity/ so I can go and fix it for my own personal installation? I've changed it in the .js files, but I just can't find it for the bookmarks header.

In the redesign I'm working on I've got this centralized to one spot, and hopefully I can just pull the info directly from Ubooquity if Tom adds my requested feature.

As for bookmarks, it should be fine for different reverse proxies now, that link isn't hardcoded. I fixed that at least one release ago. If I missed one, it would be in the bookmarks.htm file.

Anyone else get:

./PageBuilder.sh: line 31: [[[: command not found
./PageBuilder.sh: line 31: [: missing `]'

The script still runs, but I just want to make sure I'm not missing something.

Thanks for all the work on this. It's an amazing theme.

Hi how to use PageBuilder on NAS Synology ?

I have this error

./arcBuilder.sh: line 43: syntax error in conditional expression
./arcBuilder.sh: line 43: syntax error near `|'
./arcBuilder.sh: line 43: ` if [[ $systemCheck == *"Darwin"* ]||[ $system Check == *"FreeBSD"* ]]; then'


Nothing fancy here, I've just got an issue with multiple comics libraries.

I've done just like the example in the Admin screen, so that I can have a kids' comics library and not have to deal with Angry Birds comics in my own library.

The Admin example

The Result, this is actually the Browse/Publishers section. The skin gets buggy and highlights NEW no matter where I'm at. Am I missing a file?

Alright well, some of what I had done was wrong. I don't care to ever see the Comics-Kids section that I created, and really didn't care to come to this screen either.

My mistake was that I hadn't checked the box to enable separate Users in the Ubooquity Admin. Now my account loads directly into my Comics section and the kids' accounts loads directly into the Comics-Kids section.

I do find the above page interesting and possibly useful later, though.

Has anyone tried this theme out with the new Ubooquity 2.0 yet?


I pinged Tom to confirm whether or not he added script loading to themes like I asked. If so, a new release should be on the horizon.

If not, I'll have to figure the best way to proceed. I really don't want to release something that requires a user edit to Ubooquity itself to work.

I was very happy to see in the latest release that script loading has been added. Greatly looking forward to finally taking your spiffy theme out for a full-featured test drive.

Got Ubooquity 2.0.2 up and running and the theme is working again


Just tryed and it works flawlessly.

I tried it but the header images don't show and i think the folder CSS isn't being called anymore.

I think the changes to the references to folder paths has changed in ubooquity.

Just got 2.0 running myself, and this is the first thing I noticed. I'm not sure if it's syntax change or just broken.

mostly working for me, but I had not been on the latest theme version (no bookmarks etc for moi). Only thing that broke that needs fixing is the manual links I made between imprints :)

Wonder if the new version has those exposed somehow to make this less manual...

I have an idea regarding the imprint links, but I'm not sure if it's going to be worth the effort (since really, like the Publisher pages themselves, you only ever need to set them once). I'll see if I can get it working before I push my new release.

Yeah I already fixed them manually, still would be good for sharing themes with others to be able to point to something that is more permanent.


Just a heads up. It took me a while to get around to getting a 2.0 docker setup going, then had some other issues. I just want to put the last bit of polish on my new update and then I'll release it. Probably not later than next week.

It's a big enough update that it'll get it's own new thread. It's that big. :)

awesome! been waiting for your update before i start using ubooquity 2.0. 

honestly im pretty happy w/ everything as-is. i remember all the issues i had setting it up in the first place w/ your theme, im afraid of breaking it all!

You can always run them both (though not at the same time on the same ports) to make sure things are working!

Can't wait for the new update, finally installed this theme, it's fantastic

One issue with the theme, similar to Bobby Hill is or was facing, although my use case is slightly different.

So I've got 2 comics folders. I get the following screen when I click on 'Publishers'

Does the new theme update, do anything about this issue? maybe at least show the folder names? 

Yup, that's sorted in the next release. But this morning I had an idea that hopefully I can roll into the release.

What I want to do is display the pictured categories as something like comic boxes or something, and then both will display as separate publisher pages. It'll take a bit of coding to switch from a single id to multiple, but I think I can make it work.

Sweet! thanks Scott.

P.S would you be able to set something up on dropbox or maybe github where others can share their Publisher files (folder/header images, folder-info.html and folder.css files) they've created which are not included in the default set of the theme?

Telecart has something like that going, but it's semi-buried in the thread above. I do like the idea of moving to a Github page though, better for user-submissions. Something to think about! :)

Found it! Thanks @Telecart for putting this together, quite a good collection there, if anyone needs Telecart's dropbox link: https://www.dropbox.com/sh/03ipeb3tkhctlv7/AACFCmGRqTx3E1vddNI-aqiea?dl=0

Yea, Github seems perfect for this.

question, the buttons to connect to other comics when within a comic, i.e.e i went into DC and there is Vertigo and Minx...Is there a way to fix this so they will go to the sites properly without figuring out what the folder number is.  I would think a little script would fix this much like the featured items on the main page.

Yep, exactly the same setup I had that caused the above issue.  Mine was just fixed by removing my own access to my Kids' comics folder.

Awesome to hear that it's fixed in the new release!

Was this ever fixed?  I just installed today on a fresh Ubooquity install and I am seeing this.

Hi Scott, is it possible to add an option to show all comics (sorted alphabetically) ?


excuse my ignorance but is there a complete idiots guide to setting this up and running all the pagebuilder scripts?

Does anyone else have an issue with the logout button when using Nginx and Proxy Pass?  The default theme works fine when you click logout, but with this theme, it kicks it back to my root subdomain and doesn't actually log you out.


Ok after looking at this again, it has to do with the logout button on the publisher pages.  From the splash page, the logout button has "subdomain.domain.com/comics/?logout=true" but when you look at it from the publisher page it doesn't have the subfolder ("subdomain.domain.com/?logout=true").  

Ok!  So I figured it out.  The "folder-info.html" I had for it was my issue.  This is what happens when I try to work on fun stuff while at work!

I just installed following the README instructions but for some reason the Story Arc link doesn't do anything. It takes me again to the publisher page. Can somebody point me to the right direction? I'm using Ubooquity 2.

"using Ubooquity 2."

I'm fairly certain the new theme isn't ready yet. This is built for Ubooquity OG

Got it .. thanks for the clarification.

2.1 support verified?

Hi. How to use PageBuilder ? Any HOW TO ? Thanks

Hi there! Love the theme. One question - rather than going full-in with story arcs, I was hoping to be able to hack the "Featured publishers" section into "Featured series", just to highlight some of my favourite runs at the top of the publisher page there. 

I created a symbolic link folder "The Sandman" in my root comics directory and pointed it at "Sandman (1989)" which is a folder within Vertigo Comics. I was hoping then to be able to just add "The Sandman" under folder-info.html in the root comics folder (addFeatured("The Sandman");) - but somehow the addFeatured function seems to magically only work with actual publisher folders in the root comics directory -  I can't seem to get it to show a single series folder. 

I'm just wondering, is there perhaps an easy way to change the addFeatured script function slightly, so that I can feature a series folder, rather than a publishers...? 

Thanks very much in advance!

Hey there! Love the theme, thanks for posting it! Any chance of adding an indicator of how many issues are unread in a series, like the main theme does?

Also, I just realised that the bookmark icons don't always appear, like on a second page of comics. What should I look out for to make this work all the time?

Okay, got bookmarks working properly by only showing a single page.

Can't get the StoryArcs link to work though - it just goes back to the Publishers page.

After 1 week i try to use idget. How i do to use idget ?

"./iget.sh /volume1/Comics/Marvel/Daredevil" is correct ?

I try this : 

./imageGet.sh -c 'Daredevil' -d '2015'

My result is :

Comic: Daredevil

Date: 2015

Searching for Comixology page

HTTP Response: 302

Google bot detection triggered, try again later.

and when i try

./PageBuilder.sh /volume1/Comics/Marvel/Daredevil/"Daredevil V2015"/cvinfo

I have,

Downloading comic data

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

Building comic page



Usage: ./imageGet.sh -c 'Comic Name' [-d 'Comic Year'] [-r 'Which result to save']

my cvinfo as the following url


What is wrong ?

For google bot detect i change google.com for google.es

But i have the same

Downloading comic data

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

parse error: Invalid numeric literal at line 1, column 10

Building comic page



Usage: ./imageGet.sh -c 'Comic Name' [-d 'Comic Year'] [-r 'Which result to save']

my cvinfo as the following url


What is wrong ?

When i try with arcBuilder to create "Convergence" https://comicvine.gamespot.com/convergence/4045-58251/

i have this "Convergence" https://comicvine.gamespot.com/convergence/4045-56426/

What i do to fix that ?


i change

getInitial=`curl -s "https://comicvine.gamespot.com/api/story_arcs/?api_key="$apikey"&format=json&field_list=id,name,deck,publisher,image&filter=name:"${webquery}`


getInitial=`curl -s "https://comicvine.gamespot.com/api/story_arcs/?api_key="$apikey"&format=json&field_list=id,name,deck,publisher,image&filter=id:"${webquery}`

for Convergence url https://comicvine.gamespot.com/convergence/4045-58251/

the id is 58251

for Civil War II with name we have "Road to Civil War II", with id we have the url https://comicvine.gamespot.com/civil-war-ii/4045-58879/ and id is 58879

If anybody can change the arcBuilder with an id option.............

I can't find Instructions for Arcbuilder. Is there anyone that can point me to the right direction?


Would anyone be interested in something that populated more publishers?  I see that the extras has a fair number of publishers in it but on comixology itself it has a lot more publishers.  I started writing a script to extract all the publisher data from comixology.  I could use that to generate the HTML templates for this theme as well.

Sure! They keep adding new ones, so it would be great to have an extraction script! 

I've been doing a lot of them manually, and there's a GitHub maintained here. Feel free to commit any additional ones you extract.

Cool.  I shall continue working on this then.  So far I have it scraping and populating a JSON file with all the display data I'd need to write out the HTML templates.  Writing out the templates should be pretty simple.  According to my script Comixology has 198 publishers as of right now.

The main Publisher page counts 197. They have others that are "hidden" though like Tesladyne: https://www.comixology.com/Tesladyne/comics-publisher/4597-0 

or Stranger Comics: https://www.comixology.com/Stranger-Comics/comics-publisher/7406-0

Note that like Stranger Comics, a lot of the hidden ones have incomplete assets.

Not sure best route to find all of them.

From a scraping perspective the ones that don't exist on the main publisher page would all have to be hand done by url.  Which wouldn't be hard, the pages are the same, just can't get to them in a nice way.  For my first go I'm just going to focus on what can be browsed through the publisher page.

Sounds good. Keep us posted! Thanks!

The other option would be because I'm making everything JSON driven I could just have a second list of data that isn't automatically scrapable.  And just merge my scraped list with the static list, and generate everything from that point.

Either way would be good to have a tool for ongoing extraction; don't think of it as a one-time pull, since every other month I see a few extra publishers there.

I've got all the templating working now.  Last things are fetching the images and making the data generation additive instead of starting over from scratch each time. 

that's great to hear progress so soon! Awesome!

I've got a project up on GitHub now.  It is pretty rough atm but it gets the job done.  One thing I didn't realize is comixology sometimes has custom spacing between the banner and info below it.  Not much I can do about that so I just have to default everything to no spacing and that has to be hand tweaked on a publisher by publisher basis.  Anywho project is at https://github.com/astraldragon/ubooquity-comixology-publishers.  I've got the first two publishers generated maybe if you could check if they look alright.  If they do I can generate the full list.  There's a few other issues in terms of polish (error handling and such, making script additive) that I'll look at over time.

Had a hard time installing yarn but got it to work now. Seems to be extracting, and quick sanity check results look good so far!

Some of the links seem ever so slightly different than the template I see

e.g. my themes have a id="mobile" href="/theme/mobile.htm"

whereas yours has a id="mobile" href="../../theme/mobile.htm"

I think the difference might matter for reverse proxy scenarios maybe? For me it works either way.

So far all results look great, ImprintNav CSS looks good, links work. Seems to be all clear! I'll dive in more over the weekend, but great work!!

Awesome.  Yeah I noticed that the links in your templates didn't work in my setup cause I have the reverse proxy set up.  I decided to follow the layout provided here as it makes sense to align with that.  I noticed too that comiXology has some other interesting layouts that I didn't account for.  For example, https://www.comixology.co.uk/A-Wave-Blue-World/comics-publisher/76-0?ref=YnJvd3NlL3B1Ymxpc2hlci9kZXNrdG9wL2xpc3QvcHVibGlzaGVyTGlzdA

I can actually get that style working with a slightly different html layout.  It would actually solve the the padding issue I describe in the project as well.  As I would be able to read in the padding from comixology and use it in this layout.

For reference, this is the proposed layout changes: https://github.com/astraldragon/ubooquity-comixology-publishers/pull/7

I added A Wave Blue World as it show cases the layout that I was trying to solve, which actually can't work with the current way the pages lay out.

Yep, I remember having to do some manual tweaking for Viper's page too. 

One thing that would be great is to be able to just provide the URL for the "hidden" publisher pages and have it crawl for all the files needed, instead of filling in on the material in the .json file... If I'm filling in all that, might as well just do it myself! :)

True.  If you provide a list of those publishers I could add those.  Would just need the URLs and I can pipe it through the same scraping as the rest of them.  In terms of distributing the actual publisher folders.  I don't think i'll check those in to github, but I'll host them on google drive or something.  Mainly because it would make the repo over 200 megs which is pretty crazy.

If I had a priori a list of hidden publishers they wouldn't be hidden ;)

This is one of them as an example, but there are many more: https://www.comixology.com/Tesladyne/comics-publisher/4597-0

I think it would be great to just be able to add them as we find them and for the tool to scrape them ad hoc.

re: storage, I put mine on GitHub because someone earlier on the thread asked. They were on my dropbox before that, but gdrive works just as well, I'm happy either way :)

We can do that.  I might have to change the logic a little because I pull the publisher logo off of the main publisher list page.  To scrape the hidden ones I'd have to go to the publisher page, then navigate to a comic from that publisher to pull their logo.  If I made the flow the same for the non-hidden and the hidden that would make stuff more re-usable.  I was thinking a few other things I could store in the data would be the scraper that was used to pull in that data (just thinking ahead if there would ever be more than one importer).  If I have both the source url (which I'm already storing) and the importer used I'd have the ability to re-scrape an individual publisher, or list of publishers (by publisher name more than likely).  Then to add a new one I could either make it so that you could just add a new entry to the json file and specify the url and importer to use, or I could make it so that you could add it via the CLI.

That sounds great. CLI works for me. And yeah I've actually grabbed assets off comicsblitz before so agree makes sense to futureproof that scenario.


How is it going on Arcs in V2?

I have been playing around with mustache, jquery and using Json have managed to get my version of Arcs working.

The trick was to create a json file called json.cbr in the directory. (csv is so old school). This 'tricks' ubooquity to show the blank directory that it normally skips.

I then use this json file to populate the issues. I then have to also remove the json.cbr link that was created on the page. This might be what you need to get your original version working in V2 with the new themescript.js loader.

I can supply code if interested.

The next thing is to create the json file (ATM a manual process, but as only needed to do once, not a biggie).

Finally managed to get the removal code working.

Hint, Ubooquity finishes loading (including the 'false' title) before any inline scripts run.

Has anyone ran into an issue with the arcBuilder.sh script finding the wrong Story Arc in Comic Vine when there's more that one with similar names?

Example: ./arcBuilder.sh 'Secret Empire' , Finds Secret Empire Opening Salvo (Story Arc ID:59353) instead of Secret Empire (Story Arc ID:59354).

Any ideas on how to tweak the script to look for multiple Story Archs with same name and provide you with a list to select from?

Something like:

Story Arc ID:59353

Story Arc ID:59354

There were multiple listings for Secret Empire please make a selection from the list below:

1: Secret Empire Opening Salvo (Story Arc ID:59353)

2: Secret Empire (Story Arc ID:59354)

Building comic page
Comic: Secret Empire
Type: arc
Searching for Comixology page
HTTP Response: 200
Series not found
Generating arclist

Is anyone else having issues with Featured Publishers not showing up? I think it's only showing the publishers who appear on the first page of my list. I'm far from proficient in any kind of coding so sorry if I'm missing something obvious.

I was able to work around this issue by maxing out the number of items per page, but I feel like there's got to be another resolution?

This is always how it has worked for me, making me also keep increasing the number of thumbnails per page to keep Marvel on the first page ;) Not ideal, but you'll notice other CSS elements also don't translate to the following pages. It's not surprising the Featured code applies only to what it sees on the first page.

BTW, I see you have some publisher themes that aren't on the GitHub. Sharing is caring? =]


Thanks Telecart, that's what I wound up doing. I will definitely try to contribute to the GitHub. That's all new to me!

I just got into Ubooquity and I love this theme! I'm not sure if it's the theme or Ubooquity itself, but I prefer a volume number prefix in the titles here:

Can I do that? If so, what would be the best way?

Edit: Another question. I also notice a difference between my comic series page and the page from the example screenshots. What causes this difference?

You would have to modify the tags in the comic file's metadata. i use ComicRack to do that although it can be tedious. i have alot of graphic novels that when i scrape from ComicVine, it pulls in the title as "Vol 1, Vol 2, etc...". i have to manually change the title.

Thanks for your reply Jet! With hunders or thousends of comics that's an almost impossible task. Don't get me wrong. I'm willing to do a whole lot for it, but this is an insane amount of work.

you mean the publisher layer? What difference are you referring to vis-a-vis the screenshot?

just a quick question, which version of ubooquity is required to run the theme?

im on 2.1.1 and can't get it to work at all.

I use 2.1.1 and this theme. More details about what you're experiencing?

When I attempted to run Comixology on an earlier build of 2.1, I was unable to get it to work as it completely broke the CSS and everything. Are you running a specific build/version of the theme? How do you have it setup?