2026-06-07 13:27:20 +02:00
2026-06-07 10:53:55 +02:00
2026-06-07 10:53:55 +02:00
2026-06-07 13:27:20 +02:00

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 zu 001.mp3 zusammengeführt oder getrennt als 001.mp3, 002.mp3, ... exportiert werden.
  • SD-Karte: Prüft eine ausgewählte TonUINO-SD-Karte, führt dot_clean aus und kann MP3Gain mit -r -k -d 4 auf 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 01 bis 99
  • Dateien in Folgenordnern mit dreistelligem Prefix 001.mp3 bis 255.mp3
  • Spezialordner mp3 und advert mit vierstelligem Prefix 0001.mp3 bis 9999.mp3
  • macOS-Metadaten wie .DS_Store und ._*
  • 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
S
Description
No description provided
Readme
1.6 MiB
Languages
Swift 98.2%
Shell 1.8%