Aller au contenu principal

Réglez désormais vos services avec Revolut Pay

Gaprod

Aperçus vidéo Nextcloud : configurer FFmpeg

Billy Rousseau— Fondateur de Gaprod8 min read

Une vidéo s'ouvre correctement dans Nextcloud, mais son dossier affiche seulement une icône générique ? Les aperçus vidéo Nextcloud demandent un fournisseur désactivé par défaut et un binaire FFmpeg utilisable par le processus PHP. Il faut activer les deux sans supprimer les fournisseurs d'images et de texte déjà configurés.

Fonction disponible, mais déconseillée par défaut

La documentation Nextcloud 35 classe les fournisseurs PDF, SVG, bureautiques et vidéo parmi les options désactivées pour des raisons de sécurité et de performance. Elle les considère comme non prises en charge. Activez OC\\Preview\\Movie seulement pour un besoin mesuré, sur des formats maîtrisés et avec une procédure de retour arrière.

Ce que produit réellement le fournisseur Movie

Le fournisseur OC\\Preview\\Movie ne lit pas la vidéo dans le navigateur et ne la transcode pas pour la diffusion. Il demande à FFmpeg d'extraire une image fixe, puis Nextcloud redimensionne cette image pour l'afficher dans Files ou une application qui utilise le système d'aperçus.

Dans le code de Nextcloud 35, ce fournisseur accepte les types MIME video/*. Il tente une capture à 5 secondes, puis à 1 seconde et enfin au début du fichier si les essais précédents échouent. Pour une vidéo HDR, ffprobe peut détecter la fonction de transfert. La conversion de ton dépend alors aussi de la présence de libzimg dans la compilation de FFmpeg.

Cette chaîne explique trois distinctions utiles :

  • miniature : image fixe créée par FFmpeg pour représenter le fichier ;
  • lecture : capacité du navigateur ou de l'application à lire le conteneur et ses codecs ;
  • transcodage : conversion d'une vidéo vers un autre format ou débit, qui n'est pas assurée par le fournisseur Movie.

Une miniature réussie ne garantit donc pas que tous les postes liront la vidéo. À l'inverse, une vidéo lisible dans le navigateur peut rester sans miniature si le fournisseur Movie est absent, si FFmpeg manque ou si son décodeur ne prend pas en charge le codec.

Pour préparer des tailles d'aperçu avant la consultation, utilisez ensuite le guide Nextcloud Preview Generator. Cette application planifie la génération, mais elle ne remplace ni Movie ni FFmpeg.

Vérifier FFmpeg et FFprobe avant de modifier Nextcloud

Le mode d'installation détermine où ajouter les binaires. Une archive installée sur Debian ou Ubuntu utilise souvent les paquets du système. Une image Docker ou Nextcloud AIO doit recevoir FFmpeg dans le conteneur prévu par son image, pas seulement sur l'hôte. Sur un hébergement administré, l'installation relève de l'exploitant.

Commencez dans l'environnement qui exécute PHP et occ :

command -v ffmpeg
command -v ffprobe
ffmpeg -hide_banner -version
ffprobe -hide_banner -version

Un chemin affiché et une version valide prouvent la présence des programmes. Ils ne valident pas encore le codec de vos fichiers. Listez les décodeurs, puis recherchez ceux utilisés dans votre bibliothèque :

ffmpeg -hide_banner -decoders
ffmpeg -hide_banner -decoders | grep -E 'h264|hevc|vp8|vp9|av1'

La liste dépend de la compilation FFmpeg fournie par la distribution ou l'image. Ne promettez pas un format à partir de l'extension .mp4 ou .mkv : le conteneur peut renfermer des codecs différents.

Vous pouvez tester la chaîne avec une vidéo synthétique sans donnée métier. Les deux commandes suivantes construisent un fichier de huit secondes, puis extraient l'image au même instant que le premier essai de Nextcloud :

ffmpeg -hide_banner -loglevel error \
  -f lavfi -i 'testsrc2=size=640x360:rate=25' \
  -t 8 -c:v mpeg4 /tmp/nextcloud-preview-test.mp4 -y

ffmpeg -hide_banner -loglevel error \
  -ss 5 -i /tmp/nextcloud-preview-test.mp4 \
  -frames:v 1 /tmp/nextcloud-preview-test.jpg -y

Vérifiez que le JPEG existe et s'ouvre, puis supprimez les deux fichiers de test. Un échec à cette étape doit être corrigé dans FFmpeg avant toute modification de config.php.

Chaîne d'un aperçu vidéo Nextcloud depuis le fichier source vers FFmpeg puis la miniature
Movie sélectionne la vidéo, FFmpeg extrait une image et Nextcloud la redimensionne pour l'interface.

Activer Movie sans perdre les fournisseurs existants

Le réglage enabledPreviewProviders remplace la liste par défaut. Ajouter uniquement OC\\Preview\\Movie désactive donc les fournisseurs habituels qui ne figurent plus dans le tableau. Conservez les valeurs nécessaires, puis ajoutez Movie.

L'exemple suivant reprend la liste par défaut de Nextcloud 35 et active le fournisseur vidéo :

<?php
$CONFIG = [
  'enable_previews' => true,

  'preview_ffmpeg_path' => '/usr/bin/ffmpeg',
  'preview_ffprobe_path' => '/usr/bin/ffprobe',

  'enabledPreviewProviders' => [
    'OC\\Preview\\PNG',
    'OC\\Preview\\JPEG',
    'OC\\Preview\\GIF',
    'OC\\Preview\\BMP',
    'OC\\Preview\\XBitmap',
    'OC\\Preview\\Krita',
    'OC\\Preview\\WebP',
    'OC\\Preview\\MarkDown',
    'OC\\Preview\\TXT',
    'OC\\Preview\\OpenDocument',
    'OC\\Preview\\Movie',
  ],
];

Adaptez les chemins au résultat de command -v. Si preview_ffmpeg_path n'est pas défini, Nextcloud cherche ffmpeg dans le PATH du processus. Un test réussi dans votre terminal ne prouve pas que PHP-FPM possède le même PATH. Un chemin absolu rend ce point explicite.

preview_ffprobe_path sert au traitement amélioré des vidéos HDR. Sa valeur par défaut est dérivée du répertoire de FFmpeg. Le définir séparément est utile lorsque les deux binaires ne sont pas installés au même endroit.

Pour modifier cette configuration sans erreur de syntaxe, suivez le guide du fichier config.php de Nextcloud. Conservez une copie restaurable et validez le fichier avant de recharger PHP.

Tester un seul fichier avant une génération globale

Importez la vidéo synthétique ou une copie non sensible d'un fichier représentatif dans un dossier pilote. Utilisez un nouveau nom afin d'éviter qu'un ancien aperçu stocké masque le résultat. Ouvrez le dossier dans Files, puis contrôlez les journaux Nextcloud et PHP au même instant.

Le test doit répondre à ces questions :

  1. le type MIME enregistré commence-t-il par video/ ?
  2. le processus PHP peut-il exécuter le chemin FFmpeg configuré ?
  3. FFmpeg décode-t-il le flux vidéo réel ?
  4. le répertoire temporaire est-il accessible et dispose-t-il d'assez d'espace ?
  5. une image apparaît-elle pour un nouveau fichier, sans erreur associée dans les journaux ?

N'exécutez pas immédiatement une pré-génération sur toute la vidéothèque. Une extraction d'image consomme du processeur, lit une partie du fichier et utilise un emplacement temporaire. Sur un stockage distant, Nextcloud peut créer un fichier partiel pour certains MP4 ou MOV, ou récupérer davantage de données si cette méthode ne convient pas. Mesurez d'abord la durée, la charge et les lectures réseau sur quelques fichiers.

Si vous employez Preview Generator, ciblez un dossier ou un utilisateur pilote avant preview:generate-all sur l'instance. Le guide de la mémoire PHP et d'OPcache aide à séparer une limite PHP d'un problème de codec ou de binaire.

Diagnostiquer une miniature vidéo absente

SymptômeCause probableContrôle utile
Toutes les vidéos ont une icôneMovie absent de enabledPreviewProvidersLire la configuration effective et vérifier l'orthographe de la classe
Images et textes ont perdu leurs miniaturesTableau remplacé par Movie seulRestaurer les fournisseurs nécessaires dans la liste
FFmpeg fonctionne en SSH, pas dans NextcloudChemin ou droits différents pour PHPDéfinir le chemin absolu et tester avec l'utilisateur du serveur web
MP4 fonctionne, MKV échoueCodec ou flux non décodableLire ffmpeg -i, les décodeurs disponibles et le journal de l'essai
Vidéo SDR réussie, HDR échoueFFprobe absent ou FFmpeg sans chaîne HDR adaptéeVérifier les deux chemins, le transfert couleur et la compilation FFmpeg
Nouveau fichier fonctionne, ancien nonAperçu antérieur ou échec conservéTester une copie renommée avant toute opération de nettoyage
Le serveur ralentit après activationGénérations simultanées ou bibliothèque trop largeRéduire le périmètre, mesurer la concurrence et planifier les traitements

Les journaux peuvent contenir le chemin du fichier et la sortie de FFmpeg. Protégez leur accès et retirez les données personnelles avant de transmettre un extrait. Le guide Nextcloud et Imagick concerne les formats d'image et leurs délégués, pas les codecs vidéo gérés ici par FFmpeg.

Pour revenir en arrière, retirez OC\\Preview\\Movie du tableau, validez config.php, puis contrôlez qu'un nouveau fichier vidéo reçoit de nouveau l'icône générique attendue. Ne supprimez pas manuellement tout le dossier d'aperçus pour tester ce retour arrière.

Verdict

Activez les aperçus vidéo seulement si une miniature apporte une valeur réelle aux utilisateurs. Vérifiez d'abord FFmpeg, FFprobe et les décodeurs sur un fichier synthétique, ajoutez Movie sans remplacer les fournisseurs existants, puis testez un seul dossier. La lecture et le transcodage restent des sujets distincts.

Découvrir l'hébergement Nextcloud GaprodAperçus et dépendances serveur administrés selon le périmètre de l'offre

Sources officielles

Sources consultées le 22 novembre 2026, périmètre Nextcloud 35 :

Articles similaires

Prêt à démarrer avec Gaprod ?

Hébergement web, VPS et solutions cloud 100% français, avec support expert inclus.

30j rembourséMigration gratuiteSupport 7j/7