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.

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 :
- le type MIME enregistré commence-t-il par
video/? - le processus PHP peut-il exécuter le chemin FFmpeg configuré ?
- FFmpeg décode-t-il le flux vidéo réel ?
- le répertoire temporaire est-il accessible et dispose-t-il d'assez d'espace ?
- 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ôme | Cause probable | Contrôle utile |
|---|---|---|
| Toutes les vidéos ont une icône | Movie absent de enabledPreviewProviders | Lire la configuration effective et vérifier l'orthographe de la classe |
| Images et textes ont perdu leurs miniatures | Tableau remplacé par Movie seul | Restaurer les fournisseurs nécessaires dans la liste |
| FFmpeg fonctionne en SSH, pas dans Nextcloud | Chemin ou droits différents pour PHP | Définir le chemin absolu et tester avec l'utilisateur du serveur web |
| MP4 fonctionne, MKV échoue | Codec ou flux non décodable | Lire ffmpeg -i, les décodeurs disponibles et le journal de l'essai |
| Vidéo SDR réussie, HDR échoue | FFprobe absent ou FFmpeg sans chaîne HDR adaptée | Vérifier les deux chemins, le transfert couleur et la compilation FFmpeg |
| Nouveau fichier fonctionne, ancien non | Aperçu antérieur ou échec conservé | Tester une copie renommée avant toute opération de nettoyage |
| Le serveur ralentit après activation | Générations simultanées ou bibliothèque trop large | Ré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'offreSources officielles
Sources consultées le 22 novembre 2026, périmètre Nextcloud 35 :