Comment streamer la caméra d’un Raspberry Pi (2 solutions)

J’ai utilisé les caméras Raspberry Pi dans pas mal de projets au fil des années, et le streaming en direct fait partie de ces fonctions qui paraissent plus compliquées qu’elles ne le sont vraiment. Une fois la caméra en marche, il existe plusieurs façons simples de diffuser son flux vers un autre appareil.

La vidéo d’une caméra Raspberry Pi peut être diffusée en direct de deux façons : via un flux RTSP (Real-Time Streaming Protocol) ou via une page web accessible depuis un autre appareil du réseau.

Ce tutoriel couvre les deux méthodes, en commençant par le matériel et les logiciels nécessaires.

Si vous débutez avec Raspberry Pi ou Linux, j’ai quelque chose qui peut vous aider !
Téléchargez ma fiche mémo des commandes Linux gratuitement – c’est un guide de référence rapide avec toutes les commandes essentielles dont vous aurez besoin utiliser votre Raspberry Pi. Cliquez ici pour l’obtenir gratuitement !

Matériel et logiciels nécessaires

Voici le matériel dont vous aurez besoin pour ce projet :

• Raspberry Pi : je vous conseille d’utiliser un Raspberry Pi 4, mais n’importe quelle version du Pi fera l’affaire pour ce tutoriel.
• Carte SD : pour flasher la dernière version de Raspberry Pi OS, il vous faut au moins 8 Go de capacité. Vous pouvez consulter mon comparatif de cartes SD ici (ou prendre directement la meilleure sur Amazon).
• Module caméra : il existe plein d’options de caméras. Je vous conseille de prendre l’un des modules caméra officiels Raspberry Pi.

Côté logiciel, il vous faut simplement la dernière version de Raspberry Pi OS flashée sur votre carte SD (choisissez l’édition Desktop pour avoir tous les composants logiciels nécessaires).

Petit conseil : à cause de changements importants dans le logiciel de la Pi Cam avec la dernière version Trixie (celle que j’utilise pour ce tutoriel), cette méthode ne fonctionnera pas sur les anciennes distributions logicielles.

Ce tutoriel part du principe que votre caméra fonctionne déjà (vous devriez pouvoir prendre des photos), comme expliqué dans le guide complet Installer une caméra sur son Raspberry Pi : le guide ultime.

Si vous rencontrez des soucis pendant l’installation, ce guide de dépannage peut vous aider : Comment savoir si ma caméra Raspberry Pi fonctionne ?

Voilà pour les prérequis. Maintenant que tout est en ordre, on peut passer au tutoriel.

Méthode 1 : le streaming en direct via RTSP

La première façon de diffuser notre vidéo, c’est via le RTSP (Real Time Streaming Protocol). La bonne nouvelle, c’est qu’il suffit d’une seule commande dans le terminal pour lancer le stream ! Dans cette section, on va voir :

• Comment fonctionne la commande RTSP
• Comment lancer notre premier test de streaming

Lancer un flux vidéo RTSP

La commande rpicam-vid sert à enregistrer des vidéos depuis la caméra du Pi, et éventuellement à les sauvegarder si besoin. On va l’utiliser ici pour créer un flux qu’on pourra regarder depuis un autre appareil de notre réseau.

Lancez cette commande pour démarrer le streaming en direct depuis votre caméra Raspberry Pi :
rpicam-vid -t 0 -n --codec libav --libav-format mpegts -o - | cvlc stream:///dev/stdin --sout '#rtp{sdp=rtsp://:8554/stream1}'

Voici ce que fait chaque option :

• -t 0 : règle le délai d’expiration à 0 ms, donc le streaming démarre immédiatement.
• -n : pas de fenêtre d’aperçu, ce qui économise des ressources.
• –codec libav –libav-format mpegts :
• -o – : envoie le flux vers <blank>.
• On utilise ensuite ‘|’ pour rediriger cette sortie vers cvlc, un serveur média VLC en ligne de commande.
  (Note : vous pouvez sauvegarder le flux dans un fichier en indiquant un nom de fichier à la place.)
• clvc : cette commande récupère la vidéo et la diffuse en RTSP à l’adresse et sur le port que vous avez indiqués (8554 dans notre cas).

Vous allez avoir un long retour dans le terminal pendant que la commande passe en mode serveur et démarre l’enregistrement. Ne vous inquiétez pas des erreurs affichées dans l’image ci-dessous, elles n’ont aucun impact sur ce qu’on veut faire ici.

Maintenant que le serveur de streaming tourne, voyons comment regarder ce flux vidéo.

Regarder le stream en direct

La commande vue plus haut démarre l’enregistrement vidéo et crée un flux RTSP de cette vidéo. Pour accéder à ce flux, vous aurez besoin de l’adresse IP de votre Pi.

Vous pouvez récupérer votre adresse IP avec cette commande dans le terminal :ip aElle se trouve sur la ligne inet, dans la section eth0 (filaire) ou wlan0 (WiFi).

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Vous pouvez maintenant accéder à ce flux depuis le lecteur VLC installé sur votre PC. Pour ça, ouvrez l’application, puis allez dans Média >> Ouvrir un flux réseau.

On vous demandera alors où trouver le flux réseau.
Entrez l’adresse que vous avez indiquée dans la commande plus tôt :
rtsp://<IP>:8554/stream1

(N’oubliez pas de remplacer <IP> par l’adresse IP de votre Raspberry Pi.)

Et voilà, c’est tout ! Attendez juste quelques secondes le temps que le flux charge. Ensuite, vous pourrez voir le flux de la caméra du Pi en temps réel (avec quand même un délai d’environ 5 secondes) directement sur votre ordinateur.

Voilà pour cette méthode. C’était plutôt simple, non ?

Si vous cherchez une autre approche, comme accéder au flux via une page web, on va voir ça dans la section suivante.

Méthode 2 : le streaming en direct vers une page web

La méthode précédente nécessitait le lecteur VLC Media Player pour accéder au flux. Et si on voulait se passer de ce genre de dépendance ? Dans cette section, on va utiliser un logiciel tiers qui permet de diffuser une vidéo en direct directement dans un navigateur web.

Il existe pas mal d’applications différentes pour ça, mais dans ce tutoriel, on va utiliser MediaMTX. MediaMTX est un serveur de streaming en temps réel qui simplifie le routage des flux média d’une plateforme à une autre.

Pour résumer, le processus fonctionne comme ça :
Raspberry Pi Camera > MediaMTX > WebRTC packets > webpage.

Laissez-moi vous montrer comment le télécharger et faire un test de streaming.

Télécharger MediaMTX

Pour commencer, téléchargeons MediaMTX sur votre Raspberry Pi :

• Rendez-vous sur la page des releases de MediaMTX.
• Copiez le lien de la version linux_arm64, et téléchargez-la avec wget.
  (Si vous utilisez encore un ancien système 32 bits, prenez plutôt la version linux_armv7.)
• wget https://github.com/bluenviron/mediamtx/releases/download/v1.20.1/mediamtx_v1.20.1_linux_arm64.tar.gz
• Décompressez l’archive dans le dossier de votre choix avec tar :
  tar -xvzf mediamtx_v1.20.1_linux_arm64.tar.gz

Une fois terminé, vous devriez voir mediamtx, qui est le programme lui-même, et mediamtx.yml, qui est le fichier de configuration. Le programme n’a pas besoin d’être installé, il fonctionne en mode portable.

Créer un flux vidéo

Ensuite, on va modifier le fichier de configuration (mediamtx.yml) pour indiquer au programme qu’on veut diffuser la caméra du Raspberry Pi :

• Faites une sauvegarde de la configuration par défaut pour référence future :
  cp mediamtx.yml mediamtx.yml.BAK
• Ouvrez le fichier de configuration actuel pour l’éditer :
  sudo nano mediamtx.yml
• Supprimez tout pour repartir de zéro : ALT + T
• Ajoutez les lignes suivantes pour créer un flux caméra.
  Oui, ce sont seulement 3 lignes, c’est plutôt simple. Mais n’oubliez pas que l’indentation compte !

paths:
  cam:
    source: rpiCamera

• Sauvegardez et quittez (CTRL+X).
  

Maintenant que tout est configuré, vous êtes prêt à lancer le programme.
Lancez MediaMTX pour démarrer le stream :
./mediamtx

Vous allez voir MediaMTX charger plusieurs types de flux sur différents ports.
Celui qui nous intéresse, c’est WebRTC, car c’est le protocole avec la latence la plus faible pour le streaming web. Dans l’exemple ci-dessous, on voit qu’il est diffusé sur le port 8889.

Maintenant que le flux est actif, il ne reste plus qu’à y accéder depuis un autre appareil.

Regarder le stream en direct

Maintenant que le stream tourne, on peut le regarder. Ouvrez un navigateur sur un autre appareil connecté au même réseau que votre Raspberry Pi, et allez sur cette adresse :http://<IP>:8889/cam

(N’oubliez pas de remplacer <IP> par l’adresse de votre Raspberry Pi.)

Le stream en direct devrait apparaître directement dans votre navigateur ! Le délai avec cette méthode est quasi inexistant. C’est pratiquement du temps réel, contrairement à la méthode précédente.

Voilà, c’est tout pour ce tutoriel ! Aujourd’hui, on a vu comment diffuser en direct la vidéo de votre caméra Raspberry Pi avec deux méthodes différentes.

Si aucune de ces méthodes ne vous convient, voici d’autres pistes à explorer :

• Si ces méthodes vous semblent trop complexes, il existe une commande caméra plus simple pour les débutants : Comment utiliser picamzero pour prendre des photos et des vidéos.
• Si vous cherchez quelque chose de plus avancé que vous pouvez personnaliser avec du code, essayez cet exemple : mjpeg_server avec Python.
• Pour accéder à votre flux depuis internet et pas seulement depuis votre réseau local, vous pouvez utiliser une application comme ngrok.

Comme vous pouvez le voir, les possibilités sont infinies avec un Raspberry Pi et une caméra.

Ressources supplémentaires pour votre Raspberry Pi

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources