Shelfmend

Command-line tool, self-hosting tools

Coming soon Working name

Fix your audiobook library without breaking it.

$ shelfmend doctor ~/shelfmend-demo

Shelfmend doctor: ~/shelfmend-demo (read-only)
  41 books, 60 audio files, 271.0 KiB, 301.5 h of audio known (tags: builtin)

  ERROR    Damaged or truncated audio files                    2
             Rosa Quill/Tide Tables/03 - Chapter 3.mp3
             Theo Brandt/The Brass Sparrow/The Brass Sparrow.m4b
  WARNING  Audio files that may be cut short                   1
  WARNING  Encrypted Audible files (.aax)                      1
  WARNING  Duplicate books                                     1
  WARNING  One ASIN on several volumes                         1
  WARNING  Narrator or publisher stored as the author          2
  WARNING  Folder layout problems                             10
  WARNING  Broken cover images                                 1
  info     Tidy-ups (7 checks; --all lists them)              79
             for example, titles and folder names with junk in them: Lena Ashby/Bell Tower 128k

doctor is read-only: nothing was changed.

Real output from the practice library that shelfmend demo makes. Every book, author and narrator in it is invented, and only the folder path was shortened.

Where it stands

Pre-alpha, not published. The safety engine, integrity checker, duplicate cleanup, health report, author and series repair and Audiobookshelf mode are built. It hasn't been tested against a real Audiobookshelf server yet, only a stand-in, and that needs to happen before anyone points it at theirs.

Shelfmend is a command-line tool that checks an audiobook library and repairs it carefully: damaged and truncated audio, duplicates, a narrator or publisher filed as the author, a series split under two names, and folder and cover problems. Every change starts as a plan you can read, stays a dry run until you say go, and goes into an undo journal. It works with plain folders and with Audiobookshelf through its API.

Who it's for

People who keep their own audiobook library (DRM-free purchases, their own backups and CD rips), often served with Audiobookshelf. It isn't a downloader and it doesn't remove DRM.

What it does

One read-only health report for the whole library: damaged and truncated audio (checked without trusting file extensions), duplicates, misfiled authors, split series, and layout and cover problems. A terminal summary plus a single-file HTML page.
Duplicate cleanup that does not eat books: different volumes are never grouped, runtime alone never counts, a damaged copy is never kept, and a preflight check holds back any doubtful removal.
Author and series repair with evidence you can read. Series names are merged only when they differ mechanically, never across a real sub-series.
Works with Audiobookshelf through its API: metadata fixes with no folder moves and no lost listening progress, and never a forced library scan or a file deletion.
Every change starts as a plan you can review and prune, is a dry run until you say go, and is written to an undo journal. Deletions go through a reversible quarantine first.

What it keeps, and where

Shelfmend runs on your computer, collects nothing, and sends nothing anywhere except to your own Audiobookshelf server, and only when you ask it to.

Network use: Audiobookshelf API mode (only when you ask for it); Series name lookups (off until you turn it on).
What reaches Lanternwright: Nothing.

The full Shelfmend privacy section

Audiobookshelf is an independent open source project. Shelfmend is not affiliated with or endorsed by it.