Găsește filmele duplicate, titlurile nepotrivite și fișierele stricate în Emby, fără să ștergi nimic

Dacă ai un server Emby de câțiva ani, știi sentimentul: același film apare de două ori, lipsește un poster, un fișier care luna trecută rula bine se oprește la jumătate, iar discul e plin de lucruri pe care nu le mai vizionează nimeni. Emby nu are niciun raport pentru toate acestea. Library Doctor este un plugin care găsește aceste probleme, arată cât spațiu ocupă fiecare și te lasă să le rezolvi fără să ștergi vreodată un fișier. Acest tutorial parcurge întreaga rutină, de la filmele duplicate până la o carantină reversibilă, pentru cei care își administrează singuri serverele.

Cerințe preliminare

• Emby Server 4.10.1 sau mai nou, pe Linux, Windows sau Docker.
• Pentru verificarea fișierelor: nimic de instalat. Pluginul folosește ffprobe și ffmpeg care vin cu Emby.
• Pentru carantină: utilizatorul Emby are nevoie de drept de scriere în folderele bibliotecii. Pe Linux, de obicei înseamnă utilizatorul emby; în Docker, volumele media nu trebuie montate doar pentru citire (fără :ro). Fără drept de scriere, orice raport funcționează în continuare; doar carantina nu poate muta fișiere.
• O cheie de licență, un abonament activ, o licență pe viață în perioada de actualizare sau perioada de probă gratuită de 30 de zile. Fără o licență validă, pluginul este oprit: niciun raport, nicio verificare de fișiere, nicio mutare.

Pasul 1 — Instalare și activare

1. Autentifică-te în contul tău MediaLab Works, deschide Licenses și descarcă DLL-ul pluginului.
2. Copiază DLL-ul în folderul de pluginuri 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 dashboard-ului Emby și apasă License. Lipește cheia și activeaz-o, sau introdu e-mailul pentru a începe perioada de probă. Pluginul contactează serverul de licențe, leagă cheia de acest server și afișează licența ca Active.

Licența este verificată o dată pe zi și la fiecare pornire a Emby. Fără internet, pluginul continuă să funcționeze 7 zile după ultima verificare reușită. Aceeași pagină poate instala o actualizare sau poate reveni la versiunea anterioară; repornește Emby după fiecare.

Pasul 2 — Citește numerele din antet

Deschide Library Doctor din dashboard (doar administratorii). Nu e nimic de configurat: pagina citește bibliotecile de filme și episoade de fiecare dată când o deschizi. Sus vezi fișierele video, grupurile de duplicate, spațiul de recuperat din duplicate, filmele nepotrivite și dimensiunea totală. Folosește-le ca un scor rapid al stării înainte să intri în detalii.

Pasul 3 — Duplicate: află ce grupează deja Emby

Înainte să începi să muți fișiere, o distincție importantă. Emby grupează fișierele unui film ca versiuni doar când se află în același folder cu nume care se potrivesc; acestea apar ca opțiune de versiune la redare și nu sunt raportate ca duplicate de plugin. Două fișiere ale aceluiași film în foldere diferite devin două elemente separate, iar pe acestea le găsește Library Doctor.

• Filmele sunt potrivite după id-ul TMDb sau IMDb.
• Episoadele sunt potrivite după serial, sezon și număr de episod.
• Filmele fără niciunul dintre id-uri sunt potrivite după titlu (ignorând majusculele, accentele și semnele de punctuație) și an. Aceste grupuri sunt marcate după titlu și an (fără id de metadate) — de verificat, pentru că două filme diferite pot avea același titlu și același an. Deschide-le pe amândouă înainte să acționezi.

Fiecare grup arată versiunile alăturate — rezoluție, HDR, codec, debit și mărime — cu cea mai bună prima și marcată best (întâi rezoluția mai mare, apoi HDR, apoi un codec mai eficient precum AV1, HEVC sau VP9, apoi debitul), plus spațiul pe care l-ai recupera păstrând doar aceea. Dacă folosești Emby 4.10 și copiile cu același TMDb au fost grupate automat, ele pot apărea în continuare ca duplicate până când le unești; aceasta este o limitare cunoscută, nu un defect al raportului.

Pasul 4 — Filme nepotrivite

Secțiunea Unmatched movies listează filmele fără niciun id de metadate. De obicei asta înseamnă un titlu sau un an greșit, un poster lipsă și un film care nu apare niciodată în colecții sau recomandări. Apasă Open, apoi folosește Identify în Emby pentru a alege filmul corect. Dispărea din listă la următoarea deschidere a paginii.

Pasul 5 — Verifică fișierele lipsă, stricate sau tăiate

Apasă Check the files. Verificarea rulează în fundal, fișier cu fișier, cu un indicator de progres; pe o bibliotecă mare durează ceva și poți părăsi pagina. Pentru fiecare film și episod, pluginul verifică dacă fișierul există, îl citește cu ffprobe-ul din Emby (cel mult 30 de secunde), apoi decodează ultimele 3 secunde ale videoclipului cu ffmpeg-ul din Emby (cel mult 60 de secunde). Fiecare problemă este listată cu cauza ei:

• missing from disk
• cannot be read, împreună cu eroarea
• no video track: singurul „video” este o imagine, ca într-un fișier cu octeți aleatori
• no duration (broken header)
• zero duration
• the end is missing (incomplete download or copy): ultimele secunde nu pot fi decodate

Două limite asumate: un fișier tăiat foarte aproape de final (de exemplu la circa 98%) poate trece totuși, pentru că ultimele sale secunde conțin cadre decodabile, iar deteriorarea din mijlocul unui fișier nu este căutată. Un .ts tăiat nu poate fi detectat pentru că nu stochează durata. Rezultatele sunt păstrate în memorie până la repornirea Emby. Verificarea rulează doar la cerere; nu există scanări programate.

Pasul 6 — Raportul de spațiu

Secțiunea Space arată totalul, apoi spațiul pe bibliotecă, pe rezoluție (4K, 1080p, 720p, SD) și pe codec video, plus cele mai mari 20 de fișiere pe care nu le-a vizionat niciun utilizator. Este cea mai utilă pagină înainte de o extindere de disc: îți spune dacă problema ta este reprezentată de câteva remux-uri 4K uriașe sau de o coadă lungă de fișiere 720p pe care nu le deschide nimeni.

Pasul 7 — Carantină în loc de ștergere

Când apeși Quarantine pe o versiune mai slabă (și confirmi), pluginul mută fișierul video și fișierele de lângă el care îi împărtășesc numele — subtitrări, .nfo, imagini precum Movie.srt, Movie.en.srt, Movie.nfo și Movie-poster.jpg — într-un folder numit .medialab-de-sters la rădăcina folderului de bibliotecă în care se află, păstrându-le subfolderele. Pentru că folderul este în același folder de bibliotecă, se află de obicei pe același disc, iar mutarea este instantanee. Emby rescanează apoi biblioteca.

Mutarea este înregistrată înainte de a fi atins vreun fișier. Dacă un fișier nu poate fi mutat (de exemplu din cauza permisiunilor), fișierele deja mutate sunt puse la loc și nu rămâne nicio copie în urmă; dacă nici punerea lor la loc nu este posibilă, intrarea rămâne în lista Quarantine ca să o poți restaura. Lista arată fiecare titlu mutat cu locația originală și mărimea. Restore mută fișierele exact acolo unde erau și rescanează; refuză, fără să atingă nimic, dacă un fișier este atât în carantină, cât și înapoi la calea sa originală. Fișierele din afara folderelor de bibliotecă și cele deja aflate în .medialab-de-sters sunt refuzate.

Pluginul nu suprascrie și nu șterge niciodată un fișier. Când ești sigur, ștergi tu însuți folderul .medialab-de-sters de pe disc; spațiul se eliberează abia atunci. Lista este stocată în folderul de date al pluginului, așa că supraviețuiește unei reporniri Emby — nu redenumi și nu muta folderul de carantină cât timp ceva din el ar putea avea nevoie de restaurare.

Sfaturi și depanare

• Carantina spune „It could not be done”: mesajul de după el dă motivul. De obicei Emby nu are drept de scriere în folderul bibliotecii. Verifică proprietarul și permisiunile pe Linux și asigură-te că volumele Docker nu sunt montate cu :ro.
• Restaurarea spune „It could not be done”: un fișier se află deja la calea originală, de exemplu pentru că ai adăugat din nou filmul. Restaurarea refuză în loc să suprascrie.
• Un fișier din carantină apare în Emby cu noua cale: Emby a scanat folderul de carantină. Pluginul nu va pune din nou un astfel de fișier în carantină; restaurează-l sau șterge folderul când ești sigur.
• Fără interogări online: duplicatele și titlurile nepotrivite sunt calculate din id-urile pe care serverul tău le stochează deja. Singurul contact extern este clientul de licențiere. După o mutare în carantină sau o restaurare, pluginul pornește scanarea obișnuită a bibliotecii, care poate contacta furnizorii de metadate configurați pe serverul tău.
• Doar Emby Web pentru pagina de administrare. Munca se face pe server, așa că aplicațiile și televizoarele văd doar efectul.

Concluzie

Igiena bibliotecii nu este o curățenie unică; este o rutină. Deschide pagina, aruncă o privire la numere, rezolvă duplicatele și titlurile nepotrivite, rulează verificarea fișierelor după importuri mari și folosește raportul de spațiu înainte să cumperi un alt disc. Pentru că carantina mută fișierele doar în interiorul folderului bibliotecii și le readuce cu un clic, poți fi hotărât fără să-ți fie teamă. Ghidul complet este în user guide, istoricul versiunilor este în changelog, iar pagina produsului este la Library Doctor. Dacă ceva se comportă ciudat, baza de cunoștințe și FAQ sunt următoarea oprire, iar ne poți contacta oricând.