Outils pour utilisateurs

Outils du site


ffmpeg_live_streaming

Ceci est une ancienne révision du document !


Webcam streaming (avec ffmpeg)

Dans mon travail, on utilise souvent de vieux équipements basés sur des OS qui ne sont plus maintenus (coucou Windows XP!), et qu'il serait dangereux de connecter à internet. Pourtant, nous avons besoin de savoir ce qu'il se passe sur l'ordinateur sans être constamment devant. La solution la plus simple qui nous est venue est de brancher une webcam devant l'écran et de streamer le tout sur un serveur web moderne (et sécurisé).

La première solution que nous avons employée est MotionEye, notamment dans sa version OS pour Raspberry pi.
ça fait 5 ans qu'on l'utilise, on peut dire que c'est plutôt pas mal, même si ça repose sur une succession d'images fixes balancées vers le navigateur.
Mais, il y a un mais, ça ne fonctionne pas toujours. Et on ne sait pas pourquoi. Boot, marche pas, reboot marche pas, reboot marche pas, reboot marche.

On s'est donc penché sur une autre solution, basé sur du streaming de vraies vidéos. L'idée est que, de nos jours avec toutes ces visios, “on” doit pouvoir maîtriser les flux vidéos.
Qui dit stream vidéo, dit ffmpeg (surtout sur une base linux). En vrai, ça n'a pas été si facile que ça, mais au final ça marche et la solution est assez élégante.
Allez, je vous montre comment on a fait.

Matériel

  • Un raspberry pi sous Raspberry pi OS (on vise la compatibilité avec le hardware et la dispo des softwares)
  • Une webcam branchée en USB
  • Une connexion ethernet (le cuivre, y'a que ça de vrai)
  • (facultatif) un serveur web pour centraliser plusieurs Rpi+webcam

Principe

Dans les grandes lignes, on va demander à ffmpeg de capturer le flux vidéo depuis la webcam et de l'envoyer vers un serveur (nginx avec le bon module), qui se chargera de le diffuser à tous les clients qui se connectent en http.
On notera que ffmpeg ne peut diffuser que s'il y a un récepteur actif, c'est le serveur nginx qui joue ce rôle, même si aucun client n'est connecté.

Installation du Raspberry Pi

On aura un usage headless, or les versions “modernes” de Raspberry pi OS n'incluent pas de ssh par défaut, ni d'utilisateur avec login/mdp. Il faut les gérer au premier démarrage… ou rajouter des petits fichiers sur la partition boot avant le premier démarrage. J'ai noté ici comment faire.

Serveur RTMP (nginx)

Installation : apt install nginx libnginx-mod-rtmp.

Configuration en relais RTMP

On configure nginx, le bloc rtmp doit être à la racine, il ne doit pas être inclus dans le bloc http comme le son les vhost :

# nginx.conf
# Configuration de nginx en relais rtmp
rtmp {
    server {
        listen 1935;        # Listen on standard RTMP port
        chunk_size 4096;    # les paquets feront 4096 octets, le standard

        application live {
            live on;
            record off;
        }
        
    }
}

On peut envoyer un flux vers le serveur en indiquant son ip `rtmp:192.168.xxx.xxx:1935/live/stream` Le port est facultatif, car nous avons utilisé 1935 qui est le standard. Le choix de “live” comme indicateur (sous dossier) est arbitraire, ce pourrait être n'importe quoi, mais il faut que ce soit le même entre la config nginx et la config de ffmpeg. Le terme “stream” est également arbitraire, il s'agit du nom du flux, on pourrait imaginer un autre nom comme GeoCamera2. On pourrait ensuite se connecter au serveur avec un client comme VLC en indiquant l'adresse `rtmp:192.168.xxx.xxx:1935/live/stream` (mais il faut d'abord diriger le flux de la webcam au serveur)

C'est bien, mais on ne peut pas accéder au flux RTMP dans le navigateur (peut-être certains lecteurs media en JS le peuvent, mais je ne les ai pas trouvés)

Configuration pour servir en HLS

On va diffuser jusqu'à un navigateur web grâce au protocole/format HLS

# nginx.conf
# Configuration pour servir le flux en HLS
rtmp {
    server {
        listen 1935;        # Listen on standard RTMP port
        chunk_size 4096;    # les paquets feront 4096 octets, le standard

        application live {
            live on;
            record off;

            # Turn on HLS
            hls on;
            hls_path /dev/shm/hls/;
            hls_fragment 3;
            hls_playlist_length 60;
        }
    }
}

Vérification des caméras connectées

On utilise le paquet v4l-utils, préinstallé.
Il fournit la commande v4l2-ctl –list-devices, on obtient qque chose dans le genre :

user@raspberrypi:~ $ v4l2-ctl --list-devices
bcm2835-codec-decode (platform:bcm2835-codec):
	/dev/video10
	/dev/video11
        [...]
        /dev/media2
 
bcm2835-isp (platform:bcm2835-isp):
	/dev/video13
	/dev/video14
        [...]
	/dev/media0
	/dev/media1
 
# et si la caméra webcam est branchée
Microsoft® LifeCam Studio(TM): (usb-3f980000.usb-1.1.3):
	/dev/video0
	/dev/video1
	/dev/media3

Les bcmm2835 ne nous intéressent pas, il s'agit probablement de la gestion de la caméra par le connecteur CSI (nappe). La webcam que nous avons est bien de marque Microsoft, et elle est branchée en USB. C'est donc ce dernier bloc qui nous intéresse.
⇒ On apprend qu'elle accessible par /dev/video0.

ffmpeg pour la capture

inspiration, source partielle

ffmpeg permet la capture de video depuis la webcam. C'est un outil qui se lance en ligne de commande, et qui nécessite un certain nombre de paramètres pour bien définir et optimiser le flux. Il n'est pas rare de passer 1h (voir beaucoup plus) à peaufiner les paramètres de cette mono-ligne de commande quand on est débutant sur ffmpeg. Mais quelle jouissance quand ça fonctionne :)

Installation

Sur mon Raspberry Pi OS, l'installation de ffmpeg nécessite 156 paquets et 400 Mo.

Formats disponibles

On peut voir quels sont les formats

Amélioration WebRTC

On peut lire un peu partout que WebRTC est un protocole moderne (post-covid) qui gère la transmission de flux vidéo avec des latences sub-seconde, et pris en charge nativement par les navigateurs web modernes.
Ce serait donc une solution intéressante pour améliorer notre solution qui souffre d'une latence entre 5 et 10 secondes, et qui nécessite une librairie JS côté client.

Liens (pas testés):

Autre solution : le streaming d'images fixes

Je note ici en vrac des pistes que nous avons abordées, puis écartées ou pas creusées.
Elles ont toutes le point commun du mode opératoire en 2 temps : capture d'images fixes, puis diffusion par un serveur web.

fswebcam

On l'installe : apt install fswebcam

fswebcam : generate images for a webcam
options interessantes :
    -d /dev/video1  # sélection device
    -r 1920x1080    # choisir résolution
    --timestamp "%Y-%m-%d %H:%M:%S"  # afficher le timestamp sur l'image # semble inutile, y'a déjà par défaut
    --loop X  # mettre le programme en boucle, toutes les X secondes
    /!\ pas de conditions de fin, loop jusqu'à la fin des temps
    --save pic%Y-%m-%d_%H:%M:%S.jpg  # pour enregistrer les images sous un nom différent, par exemple avec un horodatage
    -b  # run in background, n'a pas l'air de fonctionner

3 usages :

  1. faire une seule image
  2. faire des captures en boucle, sur le même nom de fichier (pour un streaming par exemple)
  3. avec des noms de fichiers qui s'incrémentent pour un enregistrement

Il convient ensuite de créer un serveur web qui diffuse les images.

Idées :

  • mettre les images dans /dev/shm, qui n'est autre qu'une zone de la RAM pour éviter d'user la carte SD (et gagner en vitesse)
  • côté client, utiliser une lib JS comme htmlx pour gérer le poll régulier des images
  • Rajouter des subprocess python/cli pour vérifier si la caméra est connectée (entre le serveur central et le rpi+webcam, ping ?)

rpicam

rpicam-still –list-camera : aucune caméra USB Pourtant v4l2-ctl en trouve ⇒ rpicam ne fonctionne pas avec les caméras USB (fonctionne qu'avec la caméra Pi sur port CSI, dédié avec la nappe ?)

picamera2

L'idée est d'utiliser la lib picamera2 pour faire les captures, puis de traiter les photos avec un serveur web comme pour fswebcam. L'intérêt est qu'on peut intégrer la capture (picamera2 est un module Python) et la diffusion par le serveur web (Python aussi). Cette solution n'a pas été testée. Voici des liens qui en parle : https://raspberrytips.com/how-to-live-stream-pi-camera/ (Méthode 2) https://github.com/EbenKouao/pi-camera-stream-flask/blob/master/main.py

ffmpeg_live_streaming.1745439084.txt.gz · Dernière modification : 2025/04/23 20:11 de luc