Library Doctor Emby — ghid

Instalare

Ai nevoie de Emby Server 4.10.1 sau mai nou.

1. Autentifică-te în contul MediaLab Works, deschide Licențe și descarcă DLL-ul plugin-ului (disponibil pe abonament activ, licență lifetime în fereastra de actualizări sau în perioada de probă de 30 de zile).
2. Copiază DLL-ul în folderul de plugin-uri Emby și repornește Emby Server:
   • Linux (pachet): /var/lib/emby/plugins/
   • Docker: folderul plugins din volumul de configurare Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Deschide Library Doctor din meniul tabloului de bord Emby și apasă Licență. Lipește cheia de licență și activeaz-o sau scrie adresa de e-mail ca să pornești proba gratuită de 30 de zile ori să cumperi o licență. Plugin-ul contactează serverul de licențe, leagă cheia de acest server Emby și afișează licența ca Activă.

Licența se verifică o dată pe zi (și la fiecare pornire Emby). Fără internet plugin-ul funcționează 7 zile de la ultima verificare reușită; după aceea se oprește până poate verifica din nou.

Licență

Fără licență validă plugin-ul este oprit: nu arată niciun raport, nu rulează verificarea fișierelor și nu mută și nu readuce nimic; doar pagina Licență funcționează (de acolo pornești proba, cumperi, introduci cheia sau actualizezi). Nu se șterge nimic: fișierele din carantină rămân unde sunt și se pot readuce imediat ce licența e din nou validă.

Cu o licență validă, aceeași pagină poate instala o actualizare sau poate reveni la versiunea anterioară dacă o actualizare face probleme. Repornește Emby după oricare dintre ele.

Configurare

Deschide Library Doctor din meniul tabloului de bord Emby (doar administratorii). Nu e nimic de setat: pagina citește bibliotecile de filme și episoade de fiecare dată când o deschizi.

Înainte să folosești carantina, dă-i Emby drept de scriere în folderele bibliotecilor. Carantina creează un folder .medialab-de-sters în rădăcina fiecărui folder de bibliotecă și mută fișiere din folderele lor, deci utilizatorul sub care rulează Emby (pe Linux de obicei emby) are nevoie de drept de scriere în folderele bibliotecilor și în folderele din ele. În Docker, montează volumele cu filme pentru citire și scriere (fără :ro). Restul plugin-ului doar citește.

Utilizare zilnică

1. Cifrele de sus: fișiere video, grupuri de duplicate, spațiul de recuperat din duplicate, filme nepotrivite și mărimea totală.

2. Duplicate: fiecare grup arată versiunile, cu cea mai bună prima și marcată cea mai bună (întâi rezoluția mai mare, apoi HDR, apoi un codec mai eficient — AV1, HEVC, VP9 — apoi debitul).

   • Filmele se compară după id-ul TMDb sau IMDb, episoadele după serial, sezon și număr de episod.
   • Filmele fără id TMDb sau IMDb se compară după titlu și an. Grupurile lor sunt marcate după titlu și an (fără id de metadate) — verifică: deschide-le pe amândouă și asigură-te că e chiar același film înainte să muți unul în carantină (un remake poate avea același titlu și, uneori, același an).
   • Fișierele pe care Emby le arată deja ca versiuni ale aceluiași titlu contează ca un singur item și nu apar ca duplicate.
   • Carantină, la o versiune mai slabă, cere confirmare și mută fișierul și însoțitoarele lui în carantină (vezi mai jos).

3. Filme nepotrivite: filmele fără id de metadate. Apasă Deschide, apoi folosește Identifică din Emby ca să alegi filmul corect; dispare din listă la următoarea deschidere a paginii.

4. Fișiere lipsă, stricate sau tăiate: apasă Verifică fișierele. Verificarea rulează în fundal, fișier cu fișier, și își arată progresul; la o bibliotecă mare durează și poți părăsi pagina. Pentru fiecare fișier verifică dacă există, îl citește cu ffprobe-ul Emby (cel mult 30 de secunde), apoi decodează ultimele 3 secunde ale videoului cu ffmpeg-ul Emby (cel mult 60 de secunde). Fiecare problemă apare cu cauza:

   • lipsește de pe disc;
   • nu poate fi citit, cu eroarea;
   • fără pistă video: singurul „video” e o imagine (coperta nu contează ca video), ca într-un fișier cu octeți aleatori;
   • fără durată (antet stricat);
   • durată zero;
   • sfârșitul lipsește (descărcare/copiere incompletă): ultimele secunde nu se pot decoda. Un fișier tăiat foarte aproape de final (de exemplu pe la 98%) poate trece totuși, pentru că ultimele lui secunde pot avea încă cadre care se decodează.

   Rezultatul se păstrează până la repornirea Emby.

5. Spațiu: spațiul pe biblioteci, pe rezoluții și pe codecuri, plus cele mai mari 20 de fișiere pe care nu le-a vizionat niciun utilizator.

Carantina

• Ce se mută: fișierul video și fișierele din același folder al căror nume începe cu același nume urmat de . sau - — de exemplu Film (2010).mkv cu Film (2010).ro.srt, Film (2010).nfo și Film (2010)-poster.jpg. Celelalte fișiere din folder rămân pe loc.
• Unde: în .medialab-de-sters din rădăcina folderului de bibliotecă în care se află fișierul, cu aceleași subfoldere (/media/filme/Film (2010)/Film (2010).mkv ajunge în /media/filme/.medialab-de-sters/Film (2010)/Film (2010).mkv). Dacă în carantină există deja un fișier cu același nume, cel nou merge într-un subfolder cu nume unic, așa că nu se suprascrie nimic.
• Dacă mutarea eșuează la jumătate (de exemplu un fișier însoțitor nu se poate muta): fișierele deja mutate se pun la loc, iar copia lăsată în .medialab-de-sters de o mutare întreruptă între discuri se șterge, așa că nu ajungi cu același fișier în două locuri. Dacă nici punerea la loc nu reușește, intrarea rămâne în lista Carantină, iar Readu aduce înapoi ce s-a mutat. Pagina arată eroarea.
• După mutare plugin-ul pornește o rescanare a bibliotecii, așa că versiunea mutată dispare din Emby (Emby nu scanează folderul ascuns .medialab-de-sters, care rămâne în folderul bibliotecii). Dacă Emby arată totuși fișierul, cu noua lui cale din .medialab-de-sters, înseamnă că Emby a scanat folderul carantinei: plugin-ul nu mută din nou în carantină un astfel de fișier; readu-l sau, după ce ești sigur, șterge folderul de pe disc.
• Readucerea: lista Carantină arată fiecare titlu cu căile inițiale și mărimea. Readu mută fișierele înapoi exact de unde au plecat și rescanează biblioteca. Dacă un fișier se află și în carantină, și pe calea lui inițială (de exemplu ai adăugat filmul din nou), readucerea e refuzată și nu se atinge nimic.
• Ștergerea definitivă o faci tu: plugin-ul nu șterge niciodată. Când ești sigur, ștergi de pe disc folderul .medialab-de-sters (sau fișierele din el); abia atunci se eliberează spațiul.
• Lista fișierelor din carantină se păstrează în folderul de date al plugin-ului, deci rămâne și după repornirea Emby. Nu redenumi și nu muta folderul .medialab-de-sters cât timp ai ceva de readus din el.

Probleme frecvente

• Carantina arată „Nu s-a putut”: mesajul de după spune motivul. De obicei Emby nu are drept de scriere în folderul bibliotecii; vezi Configurare. Sunt refuzate și fișierele din afara folderelor bibliotecilor Emby și cele aflate deja în .medialab-de-sters.
• Readucerea arată „Nu s-a putut”: pe calea inițială există deja un fișier (de exemplu ai adăugat filmul din nou). Mută sau șterge acel fișier, apoi readu.
• Un grup marcat „după titlu și an — verifică” conține două filme diferite: nu muta nimic în carantină; identifică ambele filme în Emby, iar după ce primesc id-urile TMDb sau IMDb nu mai sunt grupate.
• Un film apare de două ori în bibliotecă, dar nu e la duplicate: cele două iteme au id-uri diferite, sau unul are id și celălalt nu (atunci identifică-l), sau Emby le arată deja ca versiuni ale aceluiași titlu.
• Un fișier care nu pornește nu e raportat: deteriorarea poate fi în mijlocul fișierului, care nu se verifică, sau fișierul a fost tăiat foarte aproape de final.