From 0774f45452d18fe08effc8411a43d59724361a83 Mon Sep 17 00:00:00 2001
From: alf <service@wralto.org>
Date: Wed, 9 Jul 2025 16:21:02 +0000
Subject: [PATCH] README.md aktualisiert

---
 README.md | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 73 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1997725..40c14a8 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,73 @@
-# m4b -> mp3 #
+# 🎧 m4b-to-mp3 – Kapitelweises Konvertieren von Hörbüchern
+
+Dieses Bash-Skript konvertiert `.m4b`-Hörbuchdateien automatisiert in einzelne `.mp3`-Kapiteldateien – mit korrekt gesetzten ID3-Tags, sauber formatierten Dateinamen und optionaler Fortschrittsanzeige via [`gum`](https://github.com/charmbracelet/gum).
+
+## ✨ Funktionen
+
+- Extrahiert automatisch Kapitel aus `.m4b`-Dateien
+- Benennt MP3s nach Kapitelname **mit fortlaufender Tracknummer**
+- Entfernt unzulässige Zeichen aus Dateinamen (`:`, `*`, `?`, etc.)
+- Fügt ID3-Tags hinzu: `Track`, `Title`, `Album`, `Genre`
+- Optional: Fortschrittsanzeige mit `gum`
+
+## 📦 Voraussetzungen
+
+Installiere folgende Programme, falls noch nicht vorhanden:
+
+```bash
+sudo apt install ffmpeg id3v2 jq
+```
+
+Optional (für die Fortschrittsanzeige):
+
+```bash
+# gum installieren (z. B. unter Debian/Ubuntu):
+echo "deb [trusted=yes] https://apt.fury.io/charm/ /" | sudo tee /etc/apt/sources.list.d/charm.list
+sudo apt update && sudo apt install gum
+```
+
+## 🚀 Verwendung
+
+```bash
+cd /pfad/zum/hoerbuchordner/
+bash ./konvertiere.sh
+```
+
+Das Skript:
+
+1. Bereinigt ungültige Zeichen in `.m4b`-Dateinamen
+2. Extrahiert alle Kapitel einzeln in `.mp3`-Dateien
+3. Fügt ID3-Tags hinzu
+4. Gibt saubere Fortschrittsanzeigen aus
+
+> 💡 Die Kapitel-Dateien heißen z. B.: `01 - Prolog.mp3`, `02 - Kapitel 1.mp3` usw.
+
+## 📂 Beispielstruktur
+
+Vorher:
+
+```
+📁 /Hörbuch/
+└── Die Spur des Jägers: Kommissar Mohn 1.m4b
+```
+
+Nachher:
+
+```
+📁 /Hörbuch/
+├── 01 - Prolog.mp3
+├── 02 - Kapitel 1.mp3
+├── ...
+```
+
+## 🛠️ Anpassungen
+
+Wenn du möchtest, kannst du zusätzlich:
+
+- Die Audioqualität über `-b:a` oder `-ar` anpassen
+- Kapitel in ein Unterverzeichnis speichern (z. B. `mkdir -p Kapitel/` und Pfade anpassen)
+- Coverbilder mit `ffmpeg -i cover.jpg -map 0 -map 1 -c copy -id3v2_version 3 -metadata:s:v title="Cover"` einbinden
+
+## ⚖️ Lizenz
+
+MIT – feel free to use, modify, improve!
\ No newline at end of file