Skip to content

Audiobook Organizer for Audiobookshelf

Audiobook Organizer for Audiobookshelf (and More)

Clean up audiobook folders with dry-run previews, metadata-aware layouts, rename templates, undo logs, and Audiobookshelf workflows.

Local web UI showing a metadata.json organize preview
Browser review before files move

Audiobook Organizer is for audiobook libraries that have drifted into inconsistent folder names, filenames, metadata sources, or Audiobookshelf paths. It lets you inspect what it can read, preview what it would change, run the operation, and keep an undo path while you verify the result.

Animated CLI organize run showing a full-cycle non-dry-run workflow
Full-cycle CLI organization
Animated TUI organize preview workflow
Interactive terminal preview
Animated CLI rename preview workflow
Template rename preview
TaskStart With
Organize books into Author/Series/TitleOrganize
Rename files from title, author, series, track, or disc fieldsRename Files
Use Audiobookshelf-created metadata.json filesAudiobookshelf
No metadata.json, but audio files have tagsExplore Metadata
MP3 tags use non-standard fieldsMetadata Sources
Previous organization or rename needs to be revertedSafety And Undo
Planned paths look wrongTroubleshooting
Audiobookshelf setting for storing metadata.json files

If you use Audiobookshelf, enable Store metadata with item before the first organize run. This makes ABS save a metadata.json file beside each book, and Audiobook Organizer reads that file when it previews folder changes.

After a non-dry-run organization, trigger an Audiobookshelf scan and clean up any stale missing-book entries if ABS still points at old paths.

Audiobookshelf setup and cleanup flow

Organize

Move or copy books into layouts such as Author/Series/Title, including custom layout templates.

Rename Files

Build filenames from title, author, series, track, disc, narrator, and other metadata fields.

Explore Metadata

Read metadata.json, embedded EPUB/MP3/M4B metadata, and Audiobookshelf metadata before changing files.

Work safely

Use dry-run previews, reviewed execution, skip/error summaries, and undo logs for organization and rename runs.

Coordinate with ABS

Discover Audiobookshelf libraries, test container-to-host path mappings, organize from ABS metadata, and trigger scans.

Pick your interface

Use the local web UI, scriptable CLI, keyboard-first TUI, rename flows, metadata tools, or ABS command group.