HOWTO · Python

Lire un fichier MP3 à l'aide de Python

Découvrez cinq façons de lire un fichier MP3 avec Python, avec des conseils sur l'installation, les chemins et les plateformes.

Sur cette page

Pour lire un fichier MP3 avec Python, utilisez playsound pour un petit script de lecture, pygame pour contrôler le mélangeur, ou python-vlc si VLC est disponible. Python peut aussi demander à un navigateur ou à un gestionnaire associé d’ouvrir le fichier avec webbrowser, ou lancer un lecteur installé sur le système. Dans chaque exemple, remplacez sample.mp3 par le chemin de votre fichier audio. Les chemins relatifs sont résolus à partir du répertoire de travail actuel du processus.

Lire un fichier MP3 avec playsound

Installez le paquet tiers playsound avec python -m pip install playsound. Appelez ensuite sa fonction de lecture en lui passant le chemin du fichier. Il prend en charge les formats audio courants, notamment MP3 et WAV ; la lecture dépend du moteur audio utilisé par le paquet sur votre système.

Ce script complet lit sample.mp3 depuis le répertoire de travail actuel. Installez d’abord le paquet et placez-y le fichier, ou modifiez track pour indiquer le bon chemin. La lecture nécessite un périphérique audio fonctionnel et un moteur audio compatible avec le paquet sur votre plateforme.

from pathlib import Path

track = Path("sample.mp3")
if track.is_file():
    from playsound import playsound

    playsound(str(track))

Lire un fichier MP3 avec pygame

Installez pygame avec python -m pip install pygame. Son API de mixage charge la piste et lance sa lecture. Le décodage MP3 dépend de la version de pygame et de SDL_mixer utilisée ; un fichier WAV constitue donc une solution de repli pratique si la version installée ne peut pas décoder votre MP3. Consultez la méthode pour convertir un fichier MP3 en WAV.

Ce script charge sample.mp3 depuis le répertoire de travail actuel. Installez d’abord pygame et fournissez un moteur audio. L’appel au mélangeur play() démarre la lecture de façon asynchrone ; la boucle maintient le script en cours d’exécution jusqu’à la fin de la piste. Le décodage MP3 dépend de la version de pygame et de SDL_mixer utilisée : si elle ne peut pas décoder la piste, un fichier WAV constitue une solution de repli pratique.

from pathlib import Path

track = Path("sample.mp3")
if track.is_file():
    import time

    import pygame

    pygame.mixer.init()
    pygame.mixer.music.load(str(track))
    pygame.mixer.music.play()
    while pygame.mixer.music.get_busy():
        time.sleep(0.1)

Lire un fichier MP3 avec python-vlc

python-vlc est le nom du paquet distribué par pip ; dans Python, il s’importe sous le nom vlc. Installez cette liaison avec python -m pip install python-vlc. Elle utilise le moteur multimédia natif de VLC : installez également une version compatible de VLC et vérifiez qu’elle est accessible au processus. La configuration nécessaire peut varier selon le système d’exploitation.

Ce script utilise le fichier sample.mp3 situé dans le répertoire de travail actuel. Installez la liaison python-vlc et une version compatible de VLC avant de l’exécuter. player.play() lance la lecture de façon asynchrone ; l’invite maintient donc le processus en cours pendant la lecture. Appuyez sur Entrée lorsque vous souhaitez l’arrêter. Une sortie audio est également nécessaire.

from pathlib import Path

track = Path("sample.mp3")
if track.is_file():
    import vlc

    player = vlc.MediaPlayer(str(track))
    player.play()
    input("Press Enter to stop playback.\n")
    player.stop()

Ouvrir un fichier MP3 avec webbrowser

webbrowser fait partie de la bibliothèque standard de Python et ne nécessite donc aucune installation avec pip. Cet exemple complet demande au navigateur configuré sur le système d’ouvrir une URL de fichier correspondant à sample.mp3, dans le répertoire de travail actuel. La résolution du chemin et sa conversion en URI prennent en charge les espaces et les autres caractères du chemin.

from pathlib import Path
import webbrowser

track = Path("sample.mp3")
if track.is_file():
    webbrowser.open(track.resolve().as_uri())

Cette méthode demande au navigateur ou au gestionnaire associé d’ouvrir le fichier. Elle ne garantit pas que l’audio sera lu dans un onglet : le comportement dépend du navigateur et du système d’exploitation.

Lancer un lecteur multimédia du système depuis Python

Utilisez subprocess.run avec une liste d’arguments pour lancer un lecteur en ligne de commande déjà installé. Cette méthode évite de construire une commande shell à partir du chemin du fichier. Installez le lecteur séparément ; sa disponibilité et le nom de sa commande dépendent du système d’exploitation. Les exemples ci-dessous utilisent mpg123 sous Linux et afplay sous macOS.

Ce script complet utilise mpg123 sous Linux ou afplay sous macOS pour lire sample.mp3 depuis le répertoire de travail actuel. Installez séparément le lecteur choisi. Avec une liste d’arguments, le chemin est transmis comme un seul argument, même s’il contient des espaces. check=True transforme un code de sortie non nul du lecteur en erreur Python, ce qui peut aider à diagnostiquer un échec au lancement.

from pathlib import Path
import subprocess
import sys

track = Path("sample.mp3")
if track.is_file():
    if sys.platform.startswith("linux"):
        player = "mpg123"
    elif sys.platform == "darwin":
        player = "afplay"
    else:
        raise SystemExit("Choose a player command for this operating system.")

    subprocess.run([player, str(track)], check=True)

Pour vérifier simplement un chemin avant de choisir une méthode de lecture, cet exemple Python autonome affiche le nom de fichier correspondant à un chemin situé dans le répertoire de travail actuel :

from pathlib import Path

track = Path("sample.mp3")
print(track.name)
sample.mp3