rodzalendo GitHub avatar

nanohive-abs-theme

rodzalendo

A drop-in reverse proxy that applies a cinematic dark theme with extensive customization to Audiobookshelf Web for all users without modifying the server.

Stars

34

7-day growth

No data

Forks

1

Open issues

1

License

MIT

Last updated

2026-07-22

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a professional, customizable UI overhaul for Audiobookshelf with server-wide defaults, per-user settings, built-in ratings, and zero modification to the ABS container.

Who it is for

  • Audiobookshelf server administrators
  • Self-hosters wanting a polished UI
  • Home media server enthusiasts
  • Users who want per-user theming without browser extensions

Use cases

  • Deploying a themed Audiobookshelf frontend for a family or shared server
  • Adding community book ratings to an Audiobookshelf instance
  • Customizing appearance per user without modifying the server
  • Running in air-gapped environments with offline logo hosting

Strengths

  • Drop-in deployment via a single Docker container
  • No changes to the Audiobookshelf container; removal restores stock
  • 12 base themes with configurable accent colour and per-user settings
  • Server-wide book ratings with nginx auth, no extra database

Considerations

  • Tracks Audiobookshelf DOM changes; may break on UI updates
  • User settings are stored in browser localStorage, not synced across devices
  • Requires a separate port and persistent volume for server defaults and ratings

README quick start

NanoHive ABS Theme

A drop-in reverse proxy that applies the NanoHive theme to Audiobookshelf Web for every user, with no Tampermonkey and no per-browser setup. Put it in front of your ABS server; it injects the theme's CSS and JS into the HTML it serves.

Nothing is written to your ABS container. Remove the proxy and you're back to stock.

Web only. The ABS mobile apps render natively and are unaffected — they'll keep working through the proxy, they just won't be themed.

HomeBook details

What it changes

  • A warm, cinematic dark palette with 12 base themes and a configurable accent colour
  • A hero carousel on the home page for your in-progress books
  • Redesigned book detail page: HD cover, blurred cinematic background, restructured metadata
  • A real mobile layout: drawer navigation, touch-friendly appbar, no horizontal overflow
  • An in-app settings panel (gear icon) where each user picks their own theme, font, accent, and which shelves and sidebar entries to show
  • A custom logo you can upload from the settings panel and have the server host itself, so it still loads when your server has no internet access
  • Server-wide defaults saved from the UI (admins): one click stores your current look as the default for every user — no compose editing, survives updates via a small volume
  • An expanded "Recent Series" shelf (ABS's native one is capped at 5 items), with an optional stock-ABS series look if you prefer it
  • An extended ereader: your theme colours by default, a typeface picker with curated serif / sans-serif / dyslexia-friendly (OpenDyslexic) fonts, floating player fixes
  • Ebooks in progress can join the hero carousel (default), stay a separate shelf, or be hidden — per-user choice in the customization panel
  • Covers follow your library's aspect setting everywhere, including the details page
  • Server-wide book ratings (v1.9.1+): Goodreads-style stars, score, and short reviews on every book page, shared between all users of the server — see below
  • Panel and carousel fully translated into all 40 languages ABS ships

Run it

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

Point your browser (or reverse proxy / Cloudflare tunnel) at port 8080 instead of ABS directly

Description

Audiobookshelf Web Modern Theme

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
tandpfun
Featured
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
Featured
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents
1,234