Galerie vidéo — installer le lecteur vidéo Nextcloud

Installation

1. Installez ffmpeg sur le serveur : sudo apt install ffmpeg (Debian, Ubuntu), sudo dnf install ffmpeg (Fedora, RHEL) ou sudo apk add ffmpeg (Alpine).
2. Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez l’archive de l’application videogallery-x.y.z.tar.gz (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
3. Extrayez-la dans le dossier apps/ (ou custom_apps/) de Nextcloud pour obtenir apps/videogallery/, appartenant à l’utilisateur du serveur web :

   cd /var/www/nextcloud/apps
   sudo tar -xzf ~/videogallery-x.y.z.tar.gz
   sudo chown -R www-data:www-data videogallery
   

4. Activez-la : sudo -u www-data php occ app:enable videogallery, ou depuis la page Apps.
5. Ouvrez Administration settings → Video Gallery → License, collez votre clé de licence et enregistrez. L’application contacte le serveur de licences, lie la clé à cette instance Nextcloud et affiche la licence comme Active.
6. Construisez la bibliothèque immédiatement au lieu d’attendre la tâche de fond : sudo -u www-data php occ videogallery:scan.

Licence

La licence est vérifiée une fois par jour. Sans internet, l’application continue de fonctionner 7 jours après la dernière vérification réussie ; après cela, elle est arrêtée jusqu’à pouvoir revérifier.

Sans licence valide, l’application est arrêtée : l’indexation, les tâches d’aperçu et de nettoyage ne tournent pas, la bibliothèque, le lecteur et l’API répondent avec la raison, et seule la section License continue de fonctionner (vous pouvez y démarrer l’essai, saisir la clé ou renouveler). Rien n’est supprimé : vos vidéos ne sont jamais touchées, et la bibliothèque, les positions de lecture et les paramètres sont conservés pour quand la licence redevient valide.

Configuration

Ouvrez Administration settings → Video Gallery. L’application trouve ffmpeg, teste ce que cette machine peut réellement faire et choisit elle-même un répertoire de travail ; la page indique en une phrase ce qui manque et donne la commande qui le corrige.

1. This server : les encodeurs qui fonctionnent ici (NVENC, Quick Sync, VA-API, VideoToolbox ou logiciel). Testez à nouveau le matériel après un changement de pilotes.
2. Measure this machine : teste la carte graphique avec un échantillon exigeant et conserve la meilleure combinaison fonctionnelle de préréglages et de chemin de décodage. Chaque valeur peut être outrepassée.
3. Graphics cards : avec plusieurs cartes, activez ou désactivez chacune ou donnez-lui sa propre limite.
4. Working files : le répertoire de travail pour les conversions. Pointez-le vers un disque rapide qui n’est pas le disque système ; l’application ne supprime jamais qu’à l’intérieur de son propre répertoire marqué.
5. Conversion : convertir les formats que le navigateur ne peut pas ouvrir, décoder sur la carte graphique ainsi qu’encoder, conversions simultanées, longueur des segments.
6. Quality and the connection : mesurer la connexion avant la lecture, continuer à l’ajuster pendant la lecture.
7. Previews : longueur et hauteur de l’aperçu au survol, espace pour les aperçus en cache.
8. Kinds of folder : les règles qui classent les dossiers en cours, caméra, séries et films.
9. The library : dossier créé dans chaque compte pour les vidéos, fichiers à ignorer sous une longueur donnée, chemin de ffmpeg s’il est inhabituel, périphérique VA-API.

Laisser PHP-FPM utiliser la carte graphique. De nombreuses distributions démarrent PHP-FPM avec PrivateDevices=true, ce qui cache la carte (« no CUDA-capable device is detected » alors qu’elle fonctionne depuis un shell). Pour NVIDIA, ajoutez un fichier d’extension avec sudo systemctl edit php8.4-fpm (votre version de PHP) :

[Service]
PrivateDevices=no
DevicePolicy=closed
DeviceAllow=/dev/nvidia0 rw
DeviceAllow=/dev/nvidiactl rw
DeviceAllow=/dev/nvidia-uvm rw
DeviceAllow=/dev/nvidia-uvm-tools rw
DeviceAllow=/dev/nvidia-modeset rw

Pour Intel et AMD : sudo usermod -aG render www-data. Puis sudo systemctl daemon-reload && sudo systemctl restart php8.4-fpm.

Utilisation quotidienne

• Ouvrez Video Gallery depuis le menu supérieur. Parcourez la Timeline, les dossiers ou la recherche ; changez l’Order dans la barre supérieure.
• Appuyez sur lecture : l’application choisit comment envoyer le fichier et l’affiche dans le menu de qualité (Automatic (4.0 Mbit/s)). Choisissez-y une qualité fixe si vous préférez.
• Les sous-titres et les pistes audio sont dans les menus du lecteur ; des fichiers comme Film.en.srt ou Film_en.srt à côté de la vidéo sont trouvés aussi.
• Open in another player transmet l’original à VLC ou Infuse, pour une TV ou une copie bit pour bit.
• Partagez une vidéo ou un dossier depuis son menu ; décidez si le téléchargement est autorisé.
• Commandes : occ videogallery:scan [user], occ videogallery:preview [user], occ videogallery:status [--probe], occ videogallery:cleanup [--all].

Dépannage

• Quelque chose ne se lit pas : exécutez sudo -u www-data php occ videogallery:selftest. Il convertit une partie d’un fichier réel dans les deux sens, cherche au milieu, vérifie que le résultat se lit et que rien ne reste derrière.
• La carte graphique n’est pas utilisée : vérifiez occ videogallery:status. Habituellement, PHP-FPM ne voit pas la carte (PrivateDevices) ou www-data n’est pas dans le groupe render ; voir Configuration.
• ffmpeg introuvable : installez-le, ou indiquez son chemin sous The library → Paths, if ffmpeg is somewhere unusual.
• Les nouvelles vidéos n’apparaissent pas : les tâches de fond doivent tourner (Cron) ; appuyez sur Look for new files sous The library dans les paramètres, ou exécutez occ videogallery:scan.