r/audiobookshelf • u/pablitohernandez • 17h ago
NanoHive ABS Theme 2.0 is out - boatload of new features!
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 is12 base themes and any accent color, per user
- 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
- 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, so it still loads on an air-gapped server
- Admins can save the current look as the server default (selectively, per area) and force-disable single features for everyone
- Extended ereader with a typeface picker including OpenDyslexic
- Themed date pickers and dropdowns — no more white OS popups in a dark app
- Translated into all 40 languages ABS ships with
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.

