TonUinoNator
Kleines macOS-SwiftUI-Tool zum Vorbereiten von Hörspielordnern für TonUINO/DFPlayer-SD-Karten.
Werkzeuge
Datenumwandlung: Schreibt die TonUINO-Ordnerstruktur. MP3-Dateien je Folge können zu001.mp3zusammengeführt oder getrennt als001.mp3,002.mp3, ... exportiert werden.SD-Karte: Prüft eine ausgewählte TonUINO-SD-Karte, führtdot_cleanaus und kann MP3Gain mit-r -k -d 4auf alle MP3-Dateien anwenden.ID3-Tags: Bearbeitet MP3-Tags rekursiv auf einer SD-Karte oder in einem ausgewählten Ordner.
Erwartete Input-Struktur
Input/
Folge 1/
teil 1.mp3
teil 2.mp3
Folge 2/
01.mp3
02.mp3
Die App nimmt jeden Unterordner mit Audiodateien als eine Folge. Dateien werden natürlich sortiert, also z. B. Teil 2 vor Teil 10.
Output-Struktur
Output/
01/
001.mp3
02/
001.mp3
Im Modus Zusammenführen entsteht ein nummerierter Ordner pro Folge und darin genau eine Datei 001.mp3.
Im Modus Getrennt bleiben die Dateien einer Folge getrennt:
Output/
01/
001.mp3
002.mp3
02/
001.mp3
002.mp3
Die App verarbeitet die MP3-Dateien einer Folge in natürlicher Sortierung. Andere Audioformate werden in der Vorschau gewarnt und beim Export nicht in MP3 konvertiert.
Beim Export können optional ein Zuordnungsbericht (TonUinoNator-Report.txt), dot_clean und eine anschließende TonUINO-Strukturprüfung ausgeführt werden.
Die SD-Karten-Prüfung kontrolliert:
- Folgenordner
01bis99 - Dateien in Folgenordnern mit dreistelligem Prefix
001.mp3bis255.mp3 - Spezialordner
mp3undadvertmit vierstelligem Prefix0001.mp3bis9999.mp3 - macOS-Metadaten wie
.DS_Storeund._* - unerwartete Dateien oder Ordner im Hauptverzeichnis
Die MP3Gain-Funktion setzt voraus, dass mp3gain installiert ist, z. B. unter /opt/homebrew/bin/mp3gain. Verwendet wird:
mp3gain -r -k -d 4
Das ID3-Tag-Werkzeug zeigt vorhandene Tags im Protokoll an. Es kann alle ID3-Tags löschen oder gezielt Titel, Interpret, Album, Tracknummer, Jahr, Genre, Kommentar und eingebettete Cover/Bilder entfernen. Optional wird anschließend ein neuer Kommentar in die MP3-Dateien geschrieben. Die Tag-Suche findet MP3-Dateien über ID3v2-/ID3v1-Titel, Album und Künstler und zeigt den Ordner der Datei im Protokoll.
Starten
cd TonUinoNator
swift run
Für einen schnellen Build:
swift build