VideoPromo Song Exporter

VideoPromo Song Exporter ist eine macOS-App von Strelle Records e.U. zum automatischen Schneiden von Proben- und Live-Mitschnitten anhand von Playback-Audiofiles. Die App analysiert die Audiospur eines langen Videos, erkennt passende Songs aus einem Ordner und exportiert daraus einzelne Clips in ein Zielverzeichnis.

Kurzbeschreibung

• Problem: Lange Proben- oder Live-Mitschnitte enthalten viele Songs, die man einzeln teilen oder archivieren moechte.
• Loesung: Die App gleicht die Audio-Spur des Videos mit einem Playback-Ordner ab und erstellt automatisch H.264-Clips je Song.
• Nutzen: Spart Zeit, verhindert manuelle Schneidearbeit und sorgt fuer konsistente Ergebnisse.

Typische Use Cases (verallgemeinert)

• Bandproben: Ein langes Proben-Video wird in einzelne Songs zerlegt.
• Live-Aufnahmen: Ein Set wird automatisch in Track-Clips exportiert.
• Unterricht/Musikschule: Uebungs-Sessions werden nach Stuecken sortiert.
• Content-Produktion: Social-Media-Clips entstehen schnell aus einer einzigen Aufnahme.

Was passiert technisch

1. Audio-Analyse: Die Audiospur des Videos wird extrahiert.
2. Matching: Playbacks werden ueber Audio-Merkmale (Chroma, MFCC, Onset) mit dem Video abgeglichen.
3. Vorschau: Treffer werden in einer Timeline angezeigt und koennen gefiltert oder geloescht werden.
4. Export: Aus dem Video werden Clips mit definierter Bitrate erstellt.
5. Lautheit: Audio wird linear auf -16 LUFS normalisiert (einheitliche Lautheit, keine Dynamikverdichtung).

Funktionen

• Optionale Vor-/Nachlaufzeit pro Clip
• Mindestlaenge pro Clip (z. B. 90 Sekunden)
• Match-Vorschau mit Timeline und Liste
• Auswahl/Loeschung einzelner Matches
• „Nur beste pro Song“-Auswahl (z. B. Drumless vs. Playback)
• Cache fuer schnelle Wiederholungen
• Export-Prefix aus Videometadaten: YYMMDD_Songtitel.mp4

Voraussetzungen

• ffmpeg im PATH (Homebrew: brew install ffmpeg)
• Python 3.10+
• Tkinter (bei Homebrew: brew install python-tk@3.12)

Start

GUI:

./run_app.command

CLI (falls Tkinter fehlt):

./run_cli.command

Nachbearbeitung bereits exportierter Clips

./normalize_clips.py --input "/Users/strelle/Desktop/Proben Extractor/Final Clips" --output "/Users/strelle/Desktop/Proben Extractor/Final Clips Normalized"

Kontakt

Daniel Goetzinger Strelle Records e.U Keutschacherstrasse 122, 9073 Viktring ATU66464079 | FN: 363486P Telefon: +43 660 5274104 E-Mail: office@strelle.at Web: www.strelle.at