Galería de vídeo — instala el reproductor de vídeo de Nextcloud

Instalación

Instala ffmpeg en el servidor: sudo apt install ffmpeg (Debian, Ubuntu), sudo dnf install ffmpeg (Fedora, RHEL) o sudo apk add ffmpeg (Alpine).
Inicia sesión en tu cuenta de MediaLab Works, abre Licencias y descarga el archivo de la app videogallery-x.y.z.tar.gz (disponible con una suscripción activa, una licencia de por vida dentro de su período de actualizaciones o durante la prueba gratuita de 30 días).
Extráelo en la carpeta apps/ (o custom_apps/) de Nextcloud de modo que obtengas apps/videogallery/, con propietario el usuario del servidor web:
```
cd /var/www/nextcloud/apps
sudo tar -xzf ~/videogallery-x.y.z.tar.gz
sudo chown -R www-data:www-data videogallery
```
Actívala: sudo -u www-data php occ app:enable videogallery, o desde la página Aplicaciones.
Abre Ajustes de administración → Video Gallery → License, pega tu clave de licencia y guarda. La app contacta con el servidor de licencias, vincula la clave a esta instancia de Nextcloud y muestra la licencia como Active.
Construye la biblioteca de golpe en lugar de esperar al trabajo en segundo plano: sudo -u www-data php occ videogallery:scan.

Licencia

La licencia se comprueba una vez al día. Sin internet, la app sigue funcionando 7 días después de la última comprobación exitosa; después se detiene hasta poder comprobar de nuevo.

Sin una licencia válida, la app se detiene: los trabajos de indexación, vistas previas y limpieza no se ejecutan, la biblioteca, el reproductor y la API responden con el motivo, y solo la sección License sigue funcionando (ahí puedes iniciar la prueba, introducir la clave o renovar). No se borra nada: tus vídeos nunca se tocan, y la biblioteca, las posiciones de visionado y los ajustes se conservan para cuando la licencia vuelva a ser válida.

Configuración

Abre Ajustes de administración → Video Gallery. La app encuentra ffmpeg, prueba lo que esta máquina realmente puede hacer y elige por sí misma un directorio de trabajos; la página dice en una frase lo que falta y da el comando que lo arregla.

This server: los codificadores que funcionan aquí (NVENC, Quick Sync, VA-API, VideoToolbox o por software). Vuelve a pulsar Test the hardware again tras cambiar los controladores.
Measure this machine: prueba la tarjeta gráfica con una muestra exigente y guarda la mejor combinación funcionando de ajustes predefinidos y ruta de decodificación. Cada cifra puede sobrescribirse.
Graphics cards: con varias tarjetas, activa o desactiva cada una o dale su propio límite.
Working files: el directorio de trabajos para las conversiones. Apúntalo a un disco rápido que no sea el disco del sistema; la app solo borra dentro de su propio directorio marcado.
Conversion: convierte los formatos que el navegador no puede abrir, decodifica en la tarjeta gráfica además de codificar, conversiones simultáneas, longitud de segmento.
Quality and the connection: mide la conexión antes de reproducir y sigue ajustando durante la reproducción.
Previews: longitud y altura del clip al pasar el cursor, espacio para vistas previas en caché.
Kinds of folder: las reglas que clasifican las carpetas en cursos, cámara, series y películas.
The library: carpeta creada en cada cuenta para los vídeos, archivos que omitir por debajo de una duración dada, ruta de ffmpeg si está en un lugar insólito, dispositivo VA-API.

Que PHP-FPM pueda usar la tarjeta gráfica. Muchas distribuciones arrancan PHP-FPM con PrivateDevices=true, lo que oculta la tarjeta («no CUDA-capable device is detected» aunque funcione desde una shell). Para NVIDIA, añade un drop-in con sudo systemctl edit php8.4-fpm (tu versión 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

Para Intel y AMD: sudo usermod -aG render www-data. Después sudo systemctl daemon-reload && sudo systemctl restart php8.4-fpm.

Uso diario

Abre Video Gallery desde el menú superior. Navega por la Timeline, las carpetas o el buscador; cambia el Order en la barra superior.
Pulsa reproducir: la app elige cómo enviar el archivo y lo muestra en el menú de calidad (Automatic (4.0 Mbit/s)). Elige ahí una calidad fija si lo prefieres.
Los subtítulos y las pistas de audio están en los menús del reproductor; también se encuentran archivos como Film.en.srt o Film_en.srt junto al vídeo.
Open in another player entrega el original a VLC o Infuse, para un televisor o una copia bit a bit.
Comparte un vídeo o una carpeta desde su menú; decide si se puede descargar.
Comandos: occ videogallery:scan [user], occ videogallery:preview [user], occ videogallery:status [--probe], occ videogallery:cleanup [--all].

Resolución de problemas

Algo no se reproduce: ejecuta sudo -u www-data php occ videogallery:selftest. Convierte parte de un archivo real en ambos sentidos, busca en el medio, comprueba que el resultado se reproduce y que no queda nada.
No se usa la tarjeta gráfica: comprueba occ videogallery:status. Normalmente PHP-FPM no ve la tarjeta (PrivateDevices) o www-data no está en el grupo render; consulta Configuración.
ffmpeg no encontrado: instálalo o define su ruta en The library → Paths, if ffmpeg is somewhere unusual.
Los vídeos nuevos no aparecen: los trabajos en segundo plano deben ejecutarse (Cron); pulsa Look for new files en The library de los ajustes, o ejecuta occ videogallery:scan.