Version 2.4.0 is here! This is just a reminder to try out the theme for web UI of ABS.

We got:

1. Deep customization with your own name and logo, per user settings and more!
2. Global search
3. Extended eReader with additional customisations
4. Sexy carousel on the main screen - you can also hide stuff from it.
5. Ratings for your books and series - you can also import from Goodreads and Storygraph
6. Series can now have it's own separate cover
7. Revamped server statistics and server ranking
8. User profile pictures
9. Filters and sorting re-built from ground up
10. You know who is listening to the specific book and what's their progress
11. Renewed Collections
12. Useful authors and narrators pages
13. Book issue reporting to the admin
14. Search for the book on your favorite book website
15. Hide what you don't use.
16. Everything possible to toggle on or off as you please in settings

https://github.com/rodzalendo/nanohive-abs-theme

• Jade City (2017)
• Jade War (2019)
• Jade Legacy (2021)
• The Jade Setter of Janloon (2022)
• Jade Shards (2023)

• Better to Live than to Die (2015)
• Malice (2012)
• Valor (2014)
• Ruin (2015)
• Wrath (2016)

To match this set

For anyone who hasn't seen this before:
NanoHive Theme is a small nginx container you put in front of your Audiobookshelf server. It rewrites the HTML on the way out and injects a theme. Nothing gets written to your ABS container, and nothing has to be installed per browser, so every user on the server gets it, including guests. Pull the proxy out and you're back to stock ABS.

If you already run 1.x, this is a big one.

Here's what's in it:

Ratings, everywhere

Server wide star ratings with short reviews, shared between everyone on your server. Stars show on every card while browsing, you can sort and filter the library by rating from ABS's own Filter and Sort menus, and series pages show the average of the books inside. Admins can remove anyone's rating.

There's also a "Rate what you finished" row on the home page that lists books you finished but never rated — tapping one opens a rating sheet.

Stats got interesting

A Server Ranking - everyone ranked by listening time, medals for the top three, week/month/year/all time, click a person for their breakdown. It sits on Your Stats and, for admins, also under the new Server statistics page: what the whole server listens to - most played books, best rated, top genres and authors, filterable per library.

Your own stats grew a current/longest streak, this week vs last week, which weekday you actually listen on, your most listened books, authors and narrators, editable finished dates, and a Year in Review.

The ranking works for non admins too. An admin's browser publishes a small listening summary for every user to the proxy, so the board is complete without anyone else logging in. On by default; a user who switches sharing off is removed from the board and its totals and their shared data is deleted - that choice sticks.

Collections, browse pages, narrators page rebuilt

Collections are fully re-done: an icon emblem per collection instead of a wall of covers, starter templates with pre-written descriptions, book search with author fan-out when building one, and descriptions editable in the app.

Narrators and Authors are proper card pages with cover collages, book counts, a filter box and sorting, instead of a bare table.

The rest

• Custom series covers and descriptions uploaded from the app - plus a generated cover (layered deck, grid or first book) when none is
• Additional multi-sorting for library - sort by author and position in the series at the same time.. and more
• Reorderable home sections
• Search all libraries at once (Global Search) - one merged result list with a library badge per hit
• Book lookup links on the book page, Goodreads plus the biggest site for your language, 25 websites for various regions / languages
• User profile photos, shown in the top bar and the ranking, managed by the admin
• Import your ratings from a StoryGraph or Goodreads CSV export
• Hero carousel of your in-progress books on the home page
• Autoplay the next book in a series. When one ends the next starts on its own, with a notice telling you which. Off by default, since it decides what your speakers do.
• Finished book tools. A recently finished list where you can fix the date (ABS stamps when you ticked the box, not when you finished), and a list of books stuck at 97–99 percent - every book with credits or silence at the end - with one tap to mark them done.
• Report a problem. Every user gets a "Report a problem" entry in the book's three-dot menu: missing content, bad audio, won't play, wrong metadata. Admins see a live count on their account button and review the queue on the account page - refresh every 2 minutes.
• Pick your own start page (home, library, series, collections, authors)
• Upload your own logo, hosted by the proxy
• Admins can save the current look as the server default (selectively, per area) and force-disable single features for everyone
• Extended eReader customizations with a typeface picker including OpenDyslexic
• Themed date pickers for started and finished
• Translated into all 40 languages ABS ships with
• 12 base themes and any accent color, per user

Mobile

This release fixed a lot of it. I haven't tested it thoroughly but I hope you can help.

Running it

Docker, sits in front of ABS, one volume at /data/nh if you want ratings, stats and uploads to survive a container recreate. Compose example and the env vars are in the repo.

Repo: https://github.com/rodzalendo/nanohive-abs-theme

Happy to hear what's missing. Most of 2.0 came from things people asked for in 1.x.

• We Are Legion (We Are Bob) - 2016
• For We Are Many - 2017
• All These Worlds - 2017
• Heaven's River - 2020
• Not Till We Are Lost - 2024
• The Infinite Extent - 2026

I just released HiveDock

https://github.com/rodzalendo/hivedock

If you run Docker Compose on a single home server, HiveDock is one small container that replaces the three tools you're probably juggling: a stack manager, a self-building app dashboard, and an image update checker. It reads your compose files and talks to Docker directly, so everything stays in sync on its own.
Edit compose and .env in the browser with live deploy output, get a dashboard that builds itself from what's actually running (no YAML to write), and apply image updates with one click - it rewrites just the image line and redeploys, nothing auto-updates behind your back.
Your compose files stay the source of truth, so if you delete the container every stack keeps running. Six themes, five UI languages, no telemetry, MIT.
Basically all the code was written with Claude - I direct and review it, and it runs my own homelab daily.

I wanted my ABS web UI to look nicer, and I wanted everyone I share the library with to get it too, not just me with a userscript installed.

So it's a small nginx container that sits in front of ABS and injects CSS and JS into the pages it serves. Open the site, you get the theme. Nothing to install.

Dark palette with a few base themes, a hero carousel of what you're partway through, a reworked book page, and a mobile layout that isn't a squashed desktop. There's a theme icon where each person picks their own theme, logo, name, font and accent, saved in their own browser.

docker run -d -p 8080:80 \
  -v nh_theme_data:/data/nh \
  -e ABS_UPSTREAM=http://your-abs-host:80 \
  ghcr.io/rodzalendo/nanohive-abs-theme:latest

Then point your browser or reverse proxy at that instead of ABS.

Web & mobile are affected, not sure how it will look on various phones though.. I guess it is not a big deal since we have abundance of apps anyways.

It doesn't touch your ABS container, so deleting it puts you straight back to stock. It does target ABS's DOM, so an upstream UI change can break parts of it.

Worth saying plainly: most of the code was written by AI. I know what I want it to do and I tested it to death, but I'm not going to pretend I hand-wrote it.

https://github.com/rodzalendo/nanohive-abs-theme

Curious what breaks on setups I couldn't test.

Hope someone will enjoy it :)

• Prisoners of Geography (2015)
• Worth Dying For: The Power and Politics of Flags (2016)
• Divided: Why We're Living in an Age of Walls (2018)
• The Power of Geography (2021)
• The Future of Geography (2023)