Organize

Organize is the main Audiobook Organizer workflow. It previews and then moves or copies audiobook folders into consistent layouts using metadata.json files, embedded metadata, or Audiobookshelf metadata.

Safe Organize Flow

1. Choose a small source folder.
2. Choose an output folder for the first run.
3. Run a dry-run preview.
4. Review planned destinations and warnings.
5. Run the operation.
6. Keep .abook-org.log until the result is verified.

audiobook-organizer \
  --dir=/books/source \
  --out=/books/organized \
  --dry-run \
  --verbose

When the plan is correct:

audiobook-organizer \
  --dir=/books/source \
  --out=/books/organized

Common Layouts

Use a built-in layout:

audiobook-organizer --dir=/books/source --layout=author-series-title --dry-run

Use a custom layout template:

audiobook-organizer \
  --dir=/books/source \
  --layout-template="{author}/{series}/{series-count} - {title}" \
  --dry-run

See Layouts for built-in layouts and template fields.

Metadata Sources

Organize can read:

• metadata.json
• embedded EPUB metadata
• embedded MP3 tags
• embedded M4B metadata
• Audiobookshelf metadata

See Explore Metadata when the preview shows missing or incorrect fields.

Interfaces

• Browser workflow: Local Web UI
• Scriptable workflow: CLI
• Interactive terminal workflow: TUI
• ABS metadata workflow: Audiobookshelf