Skip to content

NanoHive ABS Theme 2.0.0

Choose a tag to compare

@rodzalendo rodzalendo released this 28 Jul 20:25

A themed reverse proxy for Audiobookshelf Web — no Tampermonkey, no per-browser setup, applies to every user including guests. Nothing is written to your ABS container; remove the proxy and you're back to stock.

Verified against Audiobookshelf 2.35.1 and 2.36.0.

Ratings

  • Server-wide star ratings with short reviews, shared by everyone on the server
  • Stars on every card while browsing; series show the average of the books inside
  • "Rate what you finished" row on the home page for finished-but-unrated books
  • Admin moderation of any rating

Sorting and filtering

  • Multi-level sort inside ABS's own Sort menu: up to 8 dimensions (author, series, title, year, added, duration, narrator, rating), direction per level, precedence numbered in the order you pick
  • Stackable filters in ABS's Filter menu: genre, author, narrator, language, decade, progress and rating — any value within a dimension, all dimensions together — each value listed with its count

Stats

  • Server Ranking: everyone ranked by listening time, medals for the top three, week/month/year/all-time, per-user drill-down
  • Server statistics (admin): most played books, best rated, top genres and authors, filterable per library
  • Your listening: current and longest streak, this week against last, the weekday you actually listen on, top books, authors and narrators
  • Year in Review
  • The ranking is complete even for users who never open the web app — an admin's browser publishes a small per-user summary. On by default; switching sharing off removes that user from the board and its totals and deletes their shared data

Frequently requested upstream

  • Autoplay the next book in a series when one ends, with a notice naming what started (off by default)
  • Finished-book tools: fix the finished date, and a list of books stuck at 97–99% with one tap to mark them done
  • Report a problem from any book's three-dot menu, with a live count and queue for admins

Browsing

  • Search every library at once, merged with a library badge per hit
  • Collections rebuilt as an instant icon-emblem grid, with starter templates and in-app descriptions
  • Narrators and Authors as card pages with cover collages, counts, filtering and sorting
  • Custom series covers and descriptions, with a generated cover (layered deck, grid or first book) as fallback
  • Per-user start page, reorderable home sections, user profile photos

Admin

  • Save the current look as the server default, selectively per area
  • Force-disable individual features for everyone
  • Tidy authors — remove authors left behind with no books

Look and platform

  • 12 base themes and any accent colour, per user
  • Hero carousel of in-progress books; redesigned book page with a cinematic background
  • Extended ereader with a typeface picker including OpenDyslexic
  • Book lookup links (Goodreads plus the biggest site for your language, 25 logos bundled)
  • Self-hosted logo upload, so it loads on an air-gapped server
  • Themed date pickers and dropdowns
  • A large mobile pass: cover-first hero, centred grids, single-scroll series page, charts that fit
  • Translated into all 40 languages ABS ships

Running it

Docker, in front of ABS. Mount one volume at /data/nh to keep ratings, stats and uploads across container recreates. Compose example and env vars in the README.

ghcr.io/rodzalendo/nanohive-abs-theme:latest