Traitement Audio Universel
Opérations audio généralistes (hors réduction de bruit) : découpage, transcodage, normalisation du volume, extraction de piste audio, concaténation, fondu, changement de vitesse. Tout est réalisé via le script partagé skills/shared/scripts/audio_ops.py qui encapsule ffmpeg, avec des paramètres déterministes et reproductibles – pas de construction de commande à la volée.
Entrée
| Champ | Obligatoire | Description |
|---|---|---|
| input_file | Oui | Chemin du fichier audio ou vidéo |
| operation | Oui | trim / convert / normalize / extract / concat / fade / speed / denoise / info |
| output_file | Non | Par défaut outputs/nom_du_sujet/{name}-{op}.{ext} |
Formats supportés : wav / mp3 / m4a / aac / flac, conteneurs vidéo mp4 / mkv / mov (pour extraction de piste).
Sortie
- Fichier audio traité (dans
outputs/nom_du_sujet/) - Chaque opération imprime la commande ffmpeg réellement exécutée + la durée / le débit / le nombre de canaux / le taux d'échantillonnage du fichier de sortie
Étapes d'exécution
Chemin du script (relatif à la racine du projet) : skills/shared/scripts/audio_ops.py. Chaque sous-commande supporte l'option -h.
0. Vérification de l'environnement + Analyse
python skills/shared/scripts/audio_ops.py info input.mp3
Le script vérifie lui-même la présence de ffmpeg/ffprobe et affiche des instructions d'installation si nécessaire. Commencez toujours par info pour afficher la durée / le débit / les canaux avant de modifier le fichier.
1. Découpage trim
# Avec heures de début et fin
python skills/shared/scripts/audio_ops.py trim in.mp3 -o outputs/nom_du_sujet/clip.mp3 --start 00:00:05 --end 00:00:20
# Avec début + durée
python skills/shared/scripts/audio_ops.py trim in.mp3 -o clip.mp3 --start 5 --duration 15
2. Transcodage 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
Le format de sortie est déterminé par l'extension du fichier (mp3/wav/m4a/aac).
3. Normalisation du volume normalize
python skills/shared/scripts/audio_ops.py normalize in.mp3 -o out.mp3
Par défaut, utilise loudnorm pour normaliser à -14 LUFS / -1.5 dBTP (loudness standard pour médias sociaux et podcasts). Utiliser --i --tp --lra pour remplacer ces valeurs.
4. Extraction de piste audio 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 # sans recodage, le plus rapide
5. Concaténation concat
python skills/shared/scripts/audio_ops.py concat a.mp3 b.mp3 c.mp3 -o all.mp3
Concatène dans l'ordre des arguments, avec recodage pour gérer les différents taux d'échantillonnage / conteneurs.
6. Fondu fade
python skills/shared/scripts/audio_ops.py fade in.mp3 -o out.mp3 --fade-in 2 --fade-out 3
--fade-out applique automatiquement le fondu N secondes avant la fin.
7. Changement de vitesse speed (avec préservation de la hauteur)
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 1.5 # vitesse x1.5
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 0.8 # ralenti
Basé sur atempo pour préserver la hauteur ; les facteurs hors de la plage 0.5-2.0 sont automatiquement enchaînés.
8. Réduction de bruit denoise (solution de repli – pour un usage dédié, voir audio-denoise)
python skills/shared/scripts/audio_ops.py denoise in.wav -o out.wav --tier 2
Limite avec audio-denoise
- audio-denoise : Skill dédié à la réduction de bruit, gère la sélection du niveau, le téléchargement des modèles, le rapport de débruitage – à utiliser pour un débruitage sérieux.
- audio-editing : Traitement audio généraliste. La sous-commande
denoisen'est qu'une solution de repli pratique ; les deux appellent le mêmeaudio_ops.py denoiseavec les mêmes capacités, mais avec des objectifs différents.
Règles
- Ne jamais supprimer le fichier original – Écrire uniquement le nouveau fichier dans
outputs/nom_du_sujet/. - Toujours faire un info avant de traiter – Afficher les informations du fichier pour éviter les erreurs.
- Pour une entrée vidéo, ne modifier que l'audio – denoise applique automatiquement
-c:v copy; utiliser extract pour extraire uniquement l'audio. - Exécution transparente – Le script affiche la commande ffmpeg réellement exécutée.
- Fonctionne sans profil – Le traitement audio ne dépend pas du profil utilisateur.
Profil utilisateur
Si un profil est disponible, les paramètres par défaut peuvent être adaptés selon les préférences de la plateforme (volume cible pour les vidéos courtes, débit cible) ; sans profil, les valeurs par défaut universelles sont utilisées (-14 LUFS, 192k).