HOWTO · Python
Convertir MP3 en WAV en Python
Dans ce tutoriel, nous verrons comment convertir MP3 en WAV en Python
Sur cette page
Pour convertir un fichier MP3 en WAV avec Python, utilisez pydub pour profiter d’une interface de bibliothèque concise, ou appelez ffmpeg pour contrôler directement ses options en ligne de commande. Dans les deux cas, l’exécutable ffmpeg doit être disponible. Le WAV est généralement non compressé et peut être beaucoup plus volumineux qu’un MP3 ; convertir un MP3 avec perte ne rétablit pas les détails audio supprimés par la compression.
Convertir un MP3 en WAV avec pydub
Installez pydub dans l’environnement qui exécute votre script avec python -m pip install pydub. Vous devez également installer l’exécutable ffmpeg et le rendre accessible depuis votre PATH ; installer pydub ne l’installe pas. Consultez le guide ffmpeg pour en savoir plus. Les étapes d’installation varient selon le système d’exploitation : utilisez le gestionnaire de paquets ou la méthode d’installation pris en charge par votre système.
Dans cet exemple, input.mp3 est le fichier source et test.wav le fichier de destination. Remplacez ces chemins par ceux de vos fichiers. Le code vérifie que le fichier source existe avant d’importer pydub ; il peut donc servir de modèle. Si le fichier source est présent, le code charge le MP3 et l’exporte au format WAV.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
from pathlib import Path
source_path = Path("input.mp3")
destination_path = Path("test.wav")
if not source_path.is_file():
print(f"Place an MP3 file at {source_path} and run again.")
else:
from pydub import AudioSegment
audio = AudioSegment.from_mp3(str(source_path))
audio.export(str(destination_path), format="wav")
print(f"Created {destination_path}")
Convertir un MP3 en WAV directement avec ffmpeg
Vous pouvez exécuter ffmpeg dans un terminal sans bibliothèque audio Python. Vérifiez que ffmpeg est installé et qu’il peut être appelé par son nom, ou indiquez le chemin complet de l’exécutable. L’argument -i désigne le fichier source et le dernier argument indique le chemin de destination : ffmpeg -i input.mp3 test.wav.
Cette commande suppose que input.mp3 se trouve dans le répertoire courant et crée test.wav, comme dans les exemples Python ci-dessous. Si le fichier source se trouve ailleurs, indiquez son chemin correct. ffmpeg peut demander confirmation avant d’écraser un fichier de destination existant ; choisissez un autre nom ou utilisez son option d’écrasement uniquement si vous souhaitez remplacer ce fichier.
Convertir un MP3 en WAV avec subprocess en Python
Dans un script Python, subprocess.run() peut transmettre une liste d’arguments au programme externe ffmpeg. Cette méthode évite de construire une chaîne de commande pour le shell et permet à Python de détecter un code de retour différent de zéro. L’exemple utilise les mêmes fichier source input.mp3 et destination test.wav que les autres méthodes ; remplacez ces deux chemins par ceux de vos fichiers. Il vérifie que le fichier source existe avant d’appeler ffmpeg.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
from pathlib import Path
import subprocess
source_path = Path("input.mp3")
destination_path = Path("test.wav")
if not source_path.is_file():
print(f"Place an MP3 file at {source_path} and run again.")
else:
subprocess.run(
["ffmpeg", "-i", str(source_path), str(destination_path)],
check=True,
)
print(f"Created {destination_path}")
Avec check=True, Python signale l’échec de la conversion au lieu de poursuivre sans avertissement. ffmpeg écrit le fichier audio de destination ; subprocess ne redirige pas sa sortie standard vers ce fichier WAV. Pour les traitements par lots, interceptez subprocess.CalledProcessError et consignez le chemin du fichier source ainsi que les détails de l’erreur afin de pouvoir diagnostiquer l’échec.
Vérifier le fichier WAV et résoudre les problèmes courants
Les trois exemples de conversion utilisent input.mp3 comme fichier source et test.wav comme destination. Si vous avez modifié la destination dans un exemple, indiquez exactement le même chemin dans destination_path ci-dessous. La vérification confirme d’abord que le fichier existe, puis l’ouvre avec le module Python wave pour vérifier qu’il contient un WAV lisible. Cette vérification est distincte de la fixture WAV synthétique qui suit : celle-ci sert à examiner un fichier WAV et ne convertit pas de MP3.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
from pathlib import Path
import wave
# Match this path to the destination used by the conversion example.
destination_path = Path("test.wav")
if not destination_path.is_file():
print(f"WAV file not found: {destination_path}")
else:
try:
with wave.open(str(destination_path), "rb") as wav_file:
print(
f"WAV: {wav_file.getnchannels()} channel(s), "
f"{wav_file.getframerate()} Hz"
)
except (OSError, wave.Error) as error:
print(f"Could not read WAV file: {error}")
L’exemple autonome suivant crée une petite fixture WAV avec la bibliothèque standard de Python, puis vérifie ses métadonnées de base. Il montre uniquement comment examiner un fichier WAV ; il ne décode pas de MP3.
from pathlib import Path
import tempfile
import wave
with tempfile.TemporaryDirectory() as directory:
output_path = Path(directory) / "test.wav"
with wave.open(str(output_path), "wb") as wav_file:
wav_file.setnchannels(1)
wav_file.setsampwidth(2)
wav_file.setframerate(8000)
wav_file.writeframes(b"\x00\x00" * 800)
with wave.open(str(output_path), "rb") as wav_file:
print(f"WAV: {wav_file.getnchannels()} channel(s), {wav_file.getframerate()} Hz")
Sortie :
WAV: 1 channel(s), 8000 Hz
Les valeurs affichées décrivent le flux WAV ; elles n’indiquent pas que sa qualité sonore est supérieure à celle du MP3 source. Si Python ne trouve pas ffmpeg, installez l’exécutable ou ajoutez son répertoire au PATH, puis redémarrez le terminal ou le processus qui exécute Python. Si ffmpeg ne parvient pas à ouvrir le fichier source, vérifiez le nom du fichier et son chemin par rapport au répertoire de travail du script. En cas d’échec de la conversion, examinez les diagnostics de ffmpeg et vérifiez que le fichier source est lisible et que le répertoire de destination est accessible en écriture. Choisissez pydub si son API plus simple convient à votre script ; utilisez ffmpeg avec subprocess si vous avez besoin d’accéder directement à ses options et au résultat du processus.