Galerie Video — instalarea playerului video Nextcloud

Instalare

  1. Instalează ffmpeg pe server: sudo apt install ffmpeg (Debian, Ubuntu), sudo dnf install ffmpeg (Fedora, RHEL) sau sudo apk add ffmpeg (Alpine).
  2. Autentifică-te în contul MediaLab Works, deschide Licențe și descarcă arhiva aplicației videogallery-x.y.z.tar.gz (disponibilă pe abonament activ, licență lifetime în fereastra de actualizări sau în perioada de probă de 30 de zile).
  3. Dezarhiveaz-o în folderul apps/ (sau custom_apps/) al Nextcloud, ca să obții apps/videogallery/, cu proprietar utilizatorul serverului web: 
    cd /var/www/nextcloud/apps
sudo tar -xzf ~/videogallery-x.y.z.tar.gz
sudo chown -R www-data:www-data videogallery
  4. Activeaz-o: sudo -u www-data php occ app:enable videogallery, sau din pagina Aplicații.
  5. Deschide Setări de administrare → Galerie Video → Licență, lipește cheia de licență și salvează. Aplicația contactează serverul de licențe, leagă cheia de această instanță Nextcloud și afișează licența ca Activă.
  6. Construiește biblioteca imediat, fără să aștepți sarcina de fundal: sudo -u www-data php occ videogallery:scan.

Licență

Licența se verifică o dată pe zi. Fără internet aplicația funcționează 7 zile de la ultima verificare reușită; după aceea se oprește până poate verifica din nou.

Fără licență validă aplicația este oprită: indexarea, previzualizările și curățarea nu rulează, biblioteca, playerul și API-ul răspund cu motivul, iar doar secțiunea Licență funcționează (de acolo pornești perioada de probă, introduci cheia sau reînnoiești). Nimic nu se șterge: videoclipurile tale nu sunt atinse niciodată, iar biblioteca, pozițiile de vizionare și setările se păstrează până când licența e din nou validă.

Configurare

Deschide Setări de administrare → Galerie Video. Aplicația găsește singură ffmpeg, testează ce poate face cu adevărat mașina și alege un director de lucru; pagina spune într-o propoziție ce lipsește și dă comanda care rezolvă.

  1. Acest server: encoderele care funcționează aici (NVENC, Quick Sync, VA-API, VideoToolbox sau software). Testează din nou echipamentul după ce schimbi driverele.
  2. Măsoară această mașină: testează placa video cu un eșantion solicitant și păstrează cea mai bună combinație funcțională de preseturi și decodare. Orice valoare poate fi suprascrisă.
  3. Plăci video: cu mai multe plăci, pornește sau oprește fiecare placă ori dă-i o limită proprie.
  4. Fișiere de lucru: directorul temporar pentru conversii. Pune-l pe un disc rapid, altul decât cel al sistemului; aplicația șterge doar în propriul director marcat.
  5. Conversie: convertește formatele pe care browserul nu le poate deschide, decodează pe placa video nu doar encodează, conversii simultane, lungimea segmentului.
  6. Calitatea și conexiunea: măsoară conexiunea înainte de redare, ajustează calitatea continuu în timpul redării.
  7. Previzualizări: lungimea și înălțimea clipului de sub cursor, spațiul pentru previzualizările păstrate.
  8. Tipuri de director: regulile care împart folderele în cursuri, cameră, seriale și filme.
  9. Biblioteca: folderul creat în fiecare cont pentru videoclipuri, fișiere sărite sub o anumită durată, calea către ffmpeg dacă e într-un loc neobișnuit, dispozitivul VA-API.

Accesul PHP-FPM la placa video. Multe distribuții pornesc PHP-FPM cu PrivateDevices=true, care ascunde placa („no CUDA-capable device is detected”, deși din terminal merge). Pentru NVIDIA, adaugă un fișier drop-in cu sudo systemctl edit php8.4-fpm (versiunea ta 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

Pentru Intel și AMD: sudo usermod -aG render www-data. Apoi sudo systemctl daemon-reload && sudo systemctl restart php8.4-fpm.

Folosire zilnică

  • Deschide Galerie Video din meniul de sus. Răsfoiește Cronologia, folderele sau caută; schimbă Ordinea din bara de sus.
  • Apasă pe redare: aplicația alege cum trimite fișierul și arată asta în meniul de calitate (Automat (4.0 Mbit/s)). Poți fixa acolo o calitate, dacă preferi.
  • Subtitrările și pistele audio sunt în meniurile playerului; sunt găsite și fișiere ca Film.ro.srt sau Film_ro.srt aflate lângă videoclip.
  • Deschide în alt player trimite originalul către VLC sau Infuse, pentru televizor sau pentru o copie identică.
  • Partajează un videoclip sau un folder din meniul lui; alegi dacă poate fi și descărcat.
  • Comenzi: occ videogallery:scan [user], occ videogallery:preview [user], occ videogallery:status [--probe], occ videogallery:cleanup [--all].

Probleme frecvente

  • Ceva nu se redă: rulează sudo -u www-data php occ videogallery:selftest. Convertește o parte dintr-un fișier real în ambele moduri, sare la mijloc, verifică dacă rezultatul se redă și dacă nu rămâne nimic în urmă.
  • Placa video nu este folosită: verifică occ videogallery:status. De obicei PHP-FPM nu vede placa (PrivateDevices) sau www-data nu este în grupul render; vezi Configurare.
  • ffmpeg nu este găsit: instalează-l sau setează-i calea la Biblioteca → Căi, dacă ffmpeg e într-un loc neobișnuit.
  • Videoclipurile noi nu apar: sarcinile de fundal trebuie să ruleze (Cron); apasă Caută fișiere noi la Biblioteca în setări sau rulează occ videogallery:scan.