Well folks, it's brand new "stable release" time.  And since the first edition of the Renegade Reader theme is officially dead, I decided to create a new thread dedicated to second edition (or "The Old Man Edition") releases.  

The latest stable releases can always be found here: Renegade Reader v2.0 (The Old Man Edition)

Below are the revisions made between the last v1 (First Edition) and the v2 (Old Man Edition). 

Enjoy!

G

Renegade Reader v2.0 (The Old Man Edition) stable release

Change - All documentation has been updated, not only reflect the changes made between the "first edition" and "the old man edition" of this theme but, to better explain how Ubooquity and this theme interact as well as including more detailed information and examples on how to configure Ubooquity and this theme to get the best results.

Addition - A Windows build of the theme editor is now included in the /themeeditor folder along with the Linux build.

Change - The theme editor program is now updated to reflect the additions/removals of themeScript.js settings variables.

Change - Created a loginBackground.png to reflect the name of this theme's build (The Old Man Edition). Should you desire to do so, feel free to create your own "loginBackground.png" image to suit your needs and replace the existing one for a more customized look.

Change - The login page is changed to only display the Renegade Reader (powered by Ubooquity) logo, the login prompts, and a background image for the login page named "loginBackground.png", located in the "/themes/RR2/login/" folder.

Addition - The theme now has two different home page templates to choose from.
Use: homepageSliders=false variable in themeScript.js to tell the theme to use the default home page template
Use: homepageSliders=true variable in themeScript.js to tell the theme to display the alternate home page template with sliders containing the latest content on the home page

Removal - Since neither Ubooquity nor this theme strictly enforce JPG/PNG decoding, the "imgType" variable was removed from the theme settings in the themeScript.js file because, decoding-wise, it's not necessary to distiguish between the two file extensions. To use the PNG format where the JPG format is expected, simply rename your PNG file's extension to JPG. Likewise, to use the JPG format where the PNG format is expected, simply rename your JPG file's extension to PNG. The decoding routines are the same for both formats. So, the expected "file name.ext" is more far more important to Ubooquity and this theme than the image's actual format.

Removal - The "removeFolders" variable has been removed from the themeScript.js settings because it was specifically meant to remove the story arcs and series pages you create from the cateogry libraries they reside in; as well as the json (mini-database) file that Ubooquity imports to create them. This is now done automatically when a story arc or series page is displayed.

Renegade Reader v2.0 beta released for public testing

Addition - You can now tell the theme "how many pages deep" it should continue to display content header titles (or content text headers) in each category library.
Use: maxFoldersToLookForTitles variable in themeScript.js and adjust numeric values only
Use: adjust numeric values per category under "Max Titles"

Addition - You can now tell the theme "how many pages deep" it should look for a new header.jpg in each category library until it defaults to the last existing one.
Use: maxFoldersToLookForHeaders variable in themeScript.js and adjust numeric values only
Use: adjust numeric values per category under "Max Headers"

Change - Content header titles (or content text headers) will no longer display (regardless of whether they're on or off) if content headers are turned off.

Addition - You can now tell the theme whether or not to adjust category library root pages for squared, rather than rectangular, images.
Use: rootFolderAdjustment=true or rootFolderAdjustment=false in themeScript.js OR
Use: Root Folder Adjustments: [checked] or [unchecked]

Addition - Latest (or new) content in home page sliders can now be bookmarked. However, because bookmark queues are category specific and because the home page does not fall into any specific category, access to the bookmark queues is restricted to the appropriate category library. Ie.. Materials bookmarked from the Latest Comics sliders on the home page are stored in the bookmark queue located in the "comics" library. While materials bookmarks from the Latest Books sliders on the home page are stored in the bookmark queue located in the "books" library. El etc.. And while, in theory, I HAVE a good idea on how to successfully display bookmark queues on the home page, any implementation will require some intense "experimentation" on my part to make it function and display the queues correctly on the home page. So, this still could be a possibility in future releases.

Addition - Library bookmarking is now category specific. Bookmark queues are located under the "Bookmarks" link in their respective category libraries.

Change - The audio books module has been completely re-written and the associated HTML/CSS files were moved from the /common/ to the /library/ folder.

Change - Completely re-wrote the breadcrumb navigation and content header handling routines so that switching between root pages in a category library does not break them.

Addition - The theme now "correctly" supports multiple root pages (shared folders) in all category libraries. Switching between root pages is done in category libraries where the multiple root pages (shared folders) exist.

Addition - If the Ubooquity setting "bypass single root folder" under the Advanced tab is on, the theme will now inform you on the home page that it must be turned off.

Change - The theme now informs you if your have not imported anything into Ubooquity's database. I took this out of the first editions because I thought it was redundant. However, since I am planning on sharing (distributing) this theme in advance, I feel that re-including on the home page is necessary.

Change - All theme related objects stored in your browser's session and local storage bins have been renamed with "Ubooquity_????" prefixes for better data organization as well as to prevent severe data mis-matches between the first and second versions of this theme.

Change - Completely re-wrote many of the base Javascript functions and HTML files used in v1+ of this theme in order to reduce the number of required configuration settings without losing functionality.

Note: The code for the v1 (or first edition) releases needs to be abandoned. The problem is that, when I started writing this theme, I had no intent to distribute it and the code, for all practical purposes, is a series of "successful experiments" rather than being pre-planned and well-structured. Therefore, as much as I wanted to avoid it, a re-write of this theme's base functions has become unavoidable. The v2 (or second edition) releases will be pre-planned and better structured because 1) I don't have to experiment to see what works with Ubooquity anymore. I learned those lessons writing the first edition releases. 2) Knowing that I plan to share the theme in advance will force me to avoid as much 'hard-coding' as possible - which, in turn, will make the theme more customizable for end users who have a minimal understanding of HTML/CSS/Javascript.

Renegade Reader v1.05 (The First Edition) - final v1 release

J'ai constaté une régression de la 3.1.0 par rapport à la 2.1.5.

Sur la page d'affichage d'un comic ou d'un magazine : 

- sur la version 2.1.5 affiche le nombre de page, le type de fichier et la taille du fichier.

- sur la version 3.1.0 l'information du nombre de page a disparue.

est ce une question de paramétrage ou une régression ?

hello

v3.1.0

commics is empty, and books it's ok
Scan is good

thank you

When my library is scanned, only the chapters saved as cbz files are added to the library. Most of my manga is just in image files, so they don't get scanned. How do I have them added too?

Other people have reported this issue here https://github.com/linuxserver/docker-ubooquity/issues/60

The page 1 of latest comics shows up but nothing after that

Does and android reader, that streams content via OPDS without downloading files locally, exist that is compatible with Ubooquity v3?
I used Kuboo with v2 and it worked by streaming cbz comics via OPDS, kept track of what was read and had an intuitive UI.
With v3 it crashes when trying to browse content and devlopment of the app has been stopped in 2019 (an archived repo exists on Github).
Does anybody know of valid alternatives?
The only android app that functions similarly, is not too clunky and has a decent UI, is Moon+ Reader but it still forces you to download the content locally before you can read it.
Thank you!

Hello,

I have several files which cannot be read by Ubooquity and the cover is not created.

I have the following log : WARN com.ubooquity.b.c - Could not read document metadata for file: CANNOTREAD.cbr - IllegalArgumentException: File could not be opened

I do not understand since the rights are the same on a file which is correctly read and a file where ubooquity is blocked to open it. (cf. those ls -lrt results) :

-rw-rw-rw- 1 admin administrators 240041475 2024-11-20 23:46 CANNOTREAD.cbr
-rw-rw-rw- 1 admin administrators 63149432 2024-11-20 23:45 CANREAD.cbr

Any idea what could make a fil not open-able ?

Caused by:

org.eclipse.jetty.http.BadMessageException: 400: Invalid SNI
	at org.eclipse.jetty.server.SecureRequestCustomizer.customize(SecureRequestCustomizer.java:267)
	at org.eclipse.jetty.server.SecureRequestCustomizer.customize(SecureRequestCustomizer.java:208)
	at org.eclipse.jetty.server.HttpChannel.lambda$handle$0(HttpChannel.java:501)
	at org.eclipse.jetty.server.HttpChannel.dispatch(HttpChannel.java:762)
	at org.eclipse.jetty.server.HttpChannel.handle(HttpChannel.java:497)
	at org.eclipse.jetty.server.HttpConnection.onFillable(HttpConnection.java:282)
	at org.eclipse.jetty.io.AbstractConnection$ReadCallback.succeeded(AbstractConnection.java:314)
	at org.eclipse.jetty.io.FillInterest.fillable(FillInterest.java:100)
	at org.eclipse.jetty.io.ssl.SslConnection$DecryptedEndPoint.onFillable(SslConnection.java:558)
	at org.eclipse.jetty.io.ssl.SslConnection.onFillable(SslConnection.java:379)
	at org.eclipse.jetty.io.ssl.SslConnection$2.succeeded(SslConnection.java:146)
	at org.eclipse.jetty.io.FillInterest.fillable(FillInterest.java:100)
	at org.eclipse.jetty.io.SelectableChannelEndPoint$1.run(SelectableChannelEndPoint.java:53)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.runTask(AdaptiveExecutionStrategy.java:416)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.consumeTask(AdaptiveExecutionStrategy.java:385)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.tryProduce(AdaptiveExecutionStrategy.java:272)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.lambda$new$0(AdaptiveExecutionStrategy.java:140)
	at org.eclipse.jetty.util.thread.ReservedThreadExecutor$ReservedThread.run(ReservedThreadExecutor.java:411)
	at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:969)
	at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.doRunJob(QueuedThreadPool.java:1194)
	at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.run(QueuedThreadPool.java:1149)
	at java.base/java.lang.Thread.run(Thread.java:840)

My keystore from v2 is raising issue now with v3.1, while everything was working fine previously. 

Could we imagine to uncheck the SNI hostname ?

Thank you

Sur une instance 3.1.0 de Ubooquity, certains comics ne sont pas scannés et n'apparaissent pas.

La même liste de comics est scannés complètement sans aucun manque sur une instance 2.1.5 de Ubooquity

I'm running headless mode in aarch64. When I click on add folder to add my sources to library,  it just shows a blank pop-up. The following error is logged: 

```

20250824 06:56:22 [qtp1368251707-46] WARN o.e.j.server.handler.ContextHandler - Unimplemented getRequestCharacterEncoding() - use org.eclipse.jetty.servlet.ServletContextHandler

```

I'm assuming it's trying to open up a file chooser using native call on the OS it's being run from. Would be nice to be able to add folders using absolute paths.