Allgemeine Audiobearbeitung
Allgemeine Audio-Operationen (außer Rauschunterdrückung): Schneiden, Konvertierung, Loudness-Normalisierung, Audiospuren extrahieren, Zusammenfügen, Ein-/Ausblenden, Geschwindigkeit ändern. Alles wird über das gemeinsame Skript skills/shared/scripts/audio_ops.py gekapselt, das ffmpeg aufruft – Parameter sind festgelegt und reproduzierbar, es werden keine Befehle spontan zusammengebaut.
Eingabe
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| input_file | Ja | Pfad zur Audio- oder Videodatei |
| operation | Ja | trim / convert / normalize / extract / concat / fade / speed / denoise / info |
| output_file | Nein | Standard: outputs/Thema/{name}-{op}.{ext} |
Unterstützte Formate: wav / mp3 / m4a / aac / flac, Video-Container: mp4 / mkv / mov (für Ton extraktion).
Ausgabe
- Verarbeitete Audiodatei (gespeichert in
outputs/Thema/) - Bei jedem Vorgang wird der tatsächlich ausgeführte ffmpeg-Befehl sowie Dauer/Bitrate/Kanäle/Samplerate der Ausgabedatei ausgegeben
Ausführungsschritte
Skriptpfad (relativ zum Projektstamm): skills/shared/scripts/audio_ops.py. Jeder Unterbefehl unterstützt -h.
0. Umgebungsprüfung + Erkundung
python skills/shared/scripts/audio_ops.py info input.mp3
Das Skript prüft selbstständig, ob ffmpeg/ffprobe vorhanden ist, und gibt bei Fehlen Installationshinweise aus. Vor Eingriffen zuerst info ausführen, um Dauer/Bitrate/Kanäle der Datei anzuzeigen.
1. Trimmen trim
# Start- und Endzeit
python skills/shared/scripts/audio_ops.py trim in.mp3 -o outputs/Thema/clip.mp3 --start 00:00:05 --end 00:00:20
# Start + Dauer
python skills/shared/scripts/audio_ops.py trim in.mp3 -o clip.mp3 --start 5 --duration 15
2. Konvertierung convert
python skills/shared/scripts/audio_ops.py convert in.wav -o out.mp3 --bitrate 192k
python skills/shared/scripts/audio_ops.py convert in.m4a -o out.wav --sample-rate 44100 --channels 2
Das Ausgabeformat wird durch die Dateierweiterung bestimmt (mp3/wav/m4a/aac).
3. Loudness-Normalisierung normalize
python skills/shared/scripts/audio_ops.py normalize in.mp3 -o out.mp3
Standardmäßig wird auf -14 LUFS / -1.5 dBTP (übliche Lautstärke für Social Media/Podcasts) normalisiert. Kann mit --i, --tp, --lra überschrieben werden.
4. Tonspur extrahieren extract
python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.m4a
python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.aac --copy # Keine Neucodierung, am schnellsten
5. Zusammenfügen concat
python skills/shared/scripts/audio_ops.py concat a.mp3 b.mp3 c.mp3 -o all.mp3
Die Dateien werden in der angegebenen Reihenfolge zusammengefügt; Neucodierung sorgt für Kompatibilität bei unterschiedlichen Sampleraten/Containern.
6. Ein-/Ausblenden fade
python skills/shared/scripts/audio_ops.py fade in.mp3 -o out.mp3 --fade-in 2 --fade-out 3
--fade-out wird automatisch N Sekunden vor dem Ende positioniert.
7. Geschwindigkeit ändern speed (Tonhöhe erhalten)
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 1.5 # 1.5× Geschwindigkeit
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 0.8 # Verlangsamen
Basierend auf atempo (Tonhöhe erhalten); bei Werten außerhalb von 0,5–2,0 wird automatisch kaskadiert.
8. Rauschunterdrückung denoise (Fallback – für Spezialfälle bitte audio-denoise verwenden)
python skills/shared/scripts/audio_ops.py denoise in.wav -o out.wav --tier 2
Abgrenzung zu audio-denoise
- audio-denoise: Spezialisiertes Skill für Rauschunterdrückung – kümmert sich um Stufenauswahl, Modell-Download, Rauschminderungsbericht usw. Wenn eine gründliche Rauschunterdrückung nötig ist, dieses verwenden.
- audio-editing: Allgemeine Audiobearbeitung. Der Befehl
denoisedient lediglich als praktischer Fallback. Beide rufen die gleicheaudio_ops.py denoise-Funktion auf und haben die gleiche Fähigkeit, unterscheiden sich aber in der Ausrichtung.
Regeln
- Originaldateien niemals löschen – Neue Dateien werden nur in
outputs/Thema/geschrieben. - Erst info, dann verarbeiten – Dateiinformationen anzeigen, um Fehlbedienungen zu vermeiden.
- Videoeingabe: Nur Audio bearbeiten – Denoise verwendet bei Video automatisch
-c:v copy; reine Tonextraktion mit extract. - Transparente Ausführung – Das Skript gibt den tatsächlichen ffmpeg-Befehl aus.
- Ohne Profile nutzbar – Die Audiobearbeitung ist nicht von Benutzerprofilen abhängig.
Profil-Erkennung
Falls ein Profil vorhanden ist, können plattformspezifische Standardparameter (z. B. Lautstärke für Kurzvideos, Zielbitrate) angewendet werden; ohne Profil wird auf allgemeine Standardwerte (-14 LUFS, 192 kbps) zurückgegriffen.