Server Admin
Manage your Audiobookshelf server from FableFrog — user accounts, library administration, backups, authentication settings, and tag/genre management.
Overview
Server Admin lets you manage your Audiobookshelf server directly from FableFrog, no browser required. If your account has admin privileges on the server, the admin tools are available in Settings > Server Admin.
This feature is designed for server owners and administrators who want to handle routine management tasks from their phone without switching to a desktop.
User Management
Create, edit, and manage user accounts on your server.
- View all users with their roles and status
- Create new users with username, password, and role assignment
- Edit existing users — change passwords, update roles, or adjust permissions
- Delete users who no longer need access
Role changes take effect immediately. Users who are currently connected will see their permissions updated on their next request.
Library Administration
Manage your server's libraries and their configuration.
- View all libraries with their media counts and storage paths
- Edit library settings including name, folder paths, and scan preferences
- Trigger library scans to pick up newly added audiobooks or ebooks
- Monitor library status to see when the last scan ran and whether any issues were detected
Backups
Create and manage server backups from your phone.
- Create a backup on demand — FableFrog triggers a server-side backup that captures your library metadata, user data, and settings
- View existing backups with timestamps and sizes
- Delete old backups to free up server storage
Backups are stored on your server, not on your device. The backup scope and format are determined by your Audiobookshelf server configuration.
Authentication Settings
Configure how users sign in to your server.
- View current auth configuration including whether OIDC/SSO is enabled
- Manage authentication providers and their settings
- Configure session and token policies for your server
Changes to authentication settings can affect all users on the server. FableFrog shows confirmation prompts before applying auth changes.
Tag & Genre Management
Organize and clean up your library's metadata at the server level.
- View all tags and genres used across your library
- Rename tags or genres — changes propagate to every book that uses them
- Merge duplicates to consolidate similar tags (e.g., "Sci-Fi" and "Science Fiction")
- Delete unused tags to keep your metadata clean
Tag and genre changes sync to all connected clients, so every user on the server sees the updated metadata.
Split Genres
A common Audiobookshelf pain point: a single genre slot containing the string "Fiction, Mystery, Thriller" instead of three discrete genres. The Split Genres tool fixes this library-wide. Reach it from Server Admin > Split Genres or from Server Admin > Tags & Genres > Genres tab. This is a Premium feature.
How It Works
- Pick a delimiter. Choose one of
,(comma — the default),;(semicolon),:(colon), or|(pipe). Apply is disabled until a delimiter is selected. - Scan. FableFrog reads every book on your server (read-only — nothing is modified yet) and produces a per-book preview of what would change.
- Preview & exclude. Each book row shows the original genre array and the proposed cleaned array side-by-side. Tap a row to exclude that book from the run; excluded books are never sent to the API.
- Apply. When you're happy, tap Apply. FableFrog walks the book list with a progress indicator and writes the cleaned arrays back via
PATCH /api/items/{id}/media. Failures are reported per-book and can be retried.
What's Guaranteed
- Lossless on what's kept. Every non-empty atom from a book's original genre array maps to a canonical entry in the same book's resulting array. Casing of the first occurrence is preserved when deduping.
- Case-insensitive dedupe.
"Fiction"and"fiction"collapse to a single entry. - No silent writes. The empty-delimiter case is a guaranteed no-op, and excluded books remain exactly as they were.
- No-op detection. Books whose cleaned genres are identical to the original are skipped — no unnecessary writes.