Files
m4b_mp3/README.md
2025-07-09 16:21:02 +00:00

73 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🎧 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!