Heute stellen wir AudiobookAutomizer vor — ein Tool das MP3, FLAC, OGG, OPUS und AAC-Hörbücher automatisch in M4B konvertiert, mit Cover, Kapitelmarkierungen und Metadaten aus Audible und iTunes. Optimiert für Audiobookshelf. 🎧

Was ist AudiobookAutomizer?

AudiobookAutomizer ist ein selbst gehostetes Konvertierungs-Tool, das Hörbücher und Hörspiele automatisch aufbereitet. konkret:

• Format-Konvertierung: MP3, FLAC, OGG, OPUS, AAC → M4B mit ffmpeg
• Kapitelmarkierungen: Jede einzelne Audiodatei wird zu einem Kapitel in der M4B — genau wie bei einem kommerziellen Hörbuch
• Metadaten: Titel, Autor, Erzähler, Serie, Erscheinungsjahr, Beschreibung — alles aus Audible und iTunes
• Cover-Art: Das richtige Cover wird automatisch von Audible/iTunes geladen und in die M4B eingebettet
• Audiobookshelf-Export: Liest vorhandene metadata.json aus Audiobookshelf-Exports — kein zusätzliches Suchen nötig wenn ihr die Bibliothek exportiert habt

GitHub

Das Projekt ist open source und auf GitHub verfügbar:

github.com/nevrion/audiobookautomizer →

Wie es funktioniert

Input-Ordner

Jeder Ordner direkt im Input-Root wird als ein Buch behandelt. Der Ordnername wird als Suchbegriff genutzt:

/input/hoerbuecher/
  Harry Potter - Der Stein der Weisen/    ← wird erkannt
    01-stein-der-weisen.mp3
    02-kammer-geheimnisse.mp3

  Hogwarts Schulbuecher/
    Quidditch im Wandel der Zeiten/
      quidditch.flac

/input/hoerspiele/
  TKKG - 001 - Das Geheimnis.../
    tkkg001.mp3

Metadaten-Erkennung

Metadaten werden in dieser Reihenfolge ermittelt — die erste verfügbare Quelle gewinnt:

1. metadata.json im Ordner (eigenes Format oder Audiobookshelf-Export)
2. Audio-Tags aus den Dateien
3. Ordnername-Parser (erkennt Muster wie Serie - #001 - Titel)
4. Audible-API — automatische Suche (kein Account nötig)
5. iTunes-API — Fallback, besonders für Hörspiele

Output

Die fertige M4B-Datei landet im konfigurierten Output-Ordner — mit Cover, Kapiteln und allen Metadaten. Bereit für Audiobookshelf.

Installation

Docker Compose

services:
  audiobookautomizer:
    image: ghcr.io/nevrion/audiobookautomizer:latest
    container_name: audiobookautomizer
    volumes:
      - /pfad/zu/input/hoerbuecher:/input/hoerbuecher
      - /pfad/zu/input/hoerspiele:/input/hoerspiele
      - /pfad/zu/output:/output
    ports:
      - "8080:8080"
    environment:
      WATCH_MODE: "true"
      SCAN_INTERVAL: "3600"
      ABS_URL: "http://192.168.1.100:13378"
      ABS_TOKEN: "dein-api-token"
    restart: unless-stopped

Unraid

Im Unraid-Terminal:

wget -O /boot/config/plugins/dockerMan/templates-user/audiobookautomizer.xml \
  https://raw.githubusercontent.com/nevrion/audiobookautomizer/main/unraid-template.xml

Dann in Unraid: Docker → Add Container — das Template AudiobookAutomizer auswählen und auf Apply klicken.

Umgebungsvariablen

Variable	Standard	Beschreibung
WATCH_MODE	false	Input-Ordner kontinuierlich überwachen
SCAN_INTERVAL	3600	Sekunden zwischen Scans (nur Watch-Mode)
ABS_URL	—	Audiobookshelf-URL
ABS_TOKEN	—	Audiobookshelf API-Token
AUDIO_BITRATE	128k	Bitrate der M4B-Ausgabe
AUDIO_CHANNELS	1	1 = Mono, 2 = Stereo
LANGUAGE	de	Sprache für API-Suche (de, en)
AUDIBLE_REGION	de	Audible-Region (de, en, uk)
WEB_PORT	8080	Port der Web-UI

Web-UI

Die Web-Oberfläche ist unter http://server:8080 erreichbar:

• /queue — Alle erkannten Bücher mit Status, Metadaten-Vorschau und Live-Log
• /gaps — Fehlende Folgen in einer Serie (benötigt ABS-Anbindung)
• /settings — Bitrate, Kanäle, Templates, ABS-Credentials

REST API

AudiobookAutomizer stellt eine JSON-API unter /api/ bereit — für KI-Agenten und externe Automatisierung:

• GET /api/queue — Alle Queue-Einträge
• GET /api/queue/{type}/{folder} — Details zu einem Buch inkl. Audible-Suchtreffer
• POST /api/queue/{type}/{folder}/search — Neue Suche bei Audible/iTunes
• POST /api/queue/{type}/{folder}/save — Metadaten als metadata.json speichern

KI-Agent-Workflow: Queue abrufen → offene Bücher mit automatischer Suche matchen → Metadaten speichern → fertig. Kein manuelles Eingreifen nötig.

Lizenz

MIT — das Projekt ist frei verfügbar und kann nachgebaut werden.

---

Filed under: Allgemein - @ 1. Mai 2026 11:29