Subs.ro Plex Subtitle Downloader - Add-on și Integrare pentru Home Assistant

Descarcă automat subtitrări în limba română de pe Subs.ro pentru Plex Media Server. (Home Assistant)

✨ Funcționalități

• Descărcare automată a subtitrării pentru fișiere video nou importate în Plex Media Server (🧩)
• Logică robustă de alegere a subtitrării pentru a selecta o versiune cât mai potrivită pentru fișierul video în cauză și pentru a minimiza cât mai mult posibil apelarea API-ului Subs.ro (🧩)
• Convertire automată a subtitrărilor în format "UTF8 with BOM" pentru o compatibilitate sporită (🧩)
• Redenumirea subtitrărilor pentru a include extensia ".ro.srt" și plasarea în folderul fișierului video pentru preluarea în mod automat și clar de către Plex Media Server (🧩)
• Rulare activități la o oră programată:
  • Descărcare subtitrări pentru toate fișierele video ce nu au o subtitrare asociată (🧩)
  • Curățare subtitrări orfane ce nu mai au un fișier video asociat (🧩)
• Rulare activități în mod manual:
  • Descărcare subtitrări pentru toate fișierele video ce nu au o subtitrare asociată (🧩+🔗)
  • Curățare subtitrări orfane ce nu mai au un fișier video asociat (🧩+🔗)
  • Descărcare subtitrare pentru cel mai recent fișier video importat în Plex Media Server (🧩+🔗)
  • Căutare și descărcare de subtitrări pentru fișierele video din librăria Plex Media Server pe baza cuvintelor cheie introduse în câmpul de căutare (🧩+🔗)
  • Căutare și ștergere de subtitrări pentru fișierele video din librăria Plex Media Server pe baza cuvintelor cheie introduse în câmpul de căutare (🧩+🔗)
• Entitate de tip senzor ce permite vizualizarea statusului add-on-ului Subs.ro Plex Subtitle Downloader și acces facil la vizualizarea logului ultimei acțiuni făcute de către acesta (🧩+🔗)

(🧩) = funcționalitate ce necesită doar instalarea add-on-ului
(🧩+🔗) = funcționalitate ce necesită atât instalarea add-on-ului cât și a integrării

🛠️ Instalare

🧩 Add-on

1. Adaugă acest repository în instanța ta de Home Assistant:
   
   
   
2. Caută add-on-ul Subs.ro Plex Subtitle Downloader și instalează-l.

🔗 Integrare

Automat prin HACS

1. Adaugă acest repository în instanța ta de Home Assistant:
   
   
2. Caută integrarea Subs.ro Plex Subtitle Downloader și instalează-o.
3. Restartează Home Assistant.
4. În secțiunea Devices & services din Home Assistant, apasă pe butonul + Add integration.
5. Caută și alege din listă Subs.ro Plex Subtitle Downloader.

Manual

1. Descarcă fișierele din acest repository.
2. Copiază folderul custom_components/subsro în directorul custom_components din Home Assistant.
3. Restartează Home Assistant.
4. În secțiunea Devices & services din Home Assistant, apasă pe butonul + Add integration.
5. Caută și alege din listă Subs.ro Plex Subtitle Downloader.

⚙️ Configurare

🧩 Add-on

Opțiune	Tip	Implicit	Descriere
plex_url	str	http://localhost:32400	Linkul către serverul Plex Media Server.
plex_token	str		Token de autentificare Plex Media Server - X-Plex-Token (vezi aici cum să îl obții).
subsro_api_key	str		Token de autentificare API Subs.ro (vezi aici cum să îl obții).
webhook_secret	password?		Parola ce va fi folosită pentru interconectarea dintre Add-on și Integrare (dacă nu se dorește folosirea Integrării câmpul poate rămâne gol).
scheduled_download	bool	ON	Activare/Dezactivare a funcției de descărcare subtitrări pentru toate fișierele video ce nu au o subtitrare asociată.
scheduled_cleanup	bool	ON	Activare/Dezactivare a funcției de curățare subtitrări orfane ce nu mai au un fișier video asociat.
scan_time	str	03:00	Ora la care vor rula funcțiile scheduled_download și/sau scheduled_cleanup.
debug_log	str	OFF	Activare/Dezactivare funcție logare detaliată.

IMPORTANT: Add-on-ul funcționează pe portul 8999. Acesta trebuie să nu fie folosit de alt add-on sau aplicație.

🪝 Webhook Plex Media Server

1. Conectează-te pe serverul tău Plex Media Server și accesează secțiunea Settings.

2. Accesează secțiunea Webhooks.

3. Apasă pe butonul Add webhook.

4. Adaugă http://homeassistant.local:8999/plex (dacă serverul de Plex nu este pe aceeași mașină cu Home Assistant, în loc de homeassistant.local pune IP-ul serverului Home Assistant) și apasă pe butonul Save Changes.

🔗 Integrare

Opțiune	Tip	Implicit	Descriere
url	str	http://localhost:8999	Linkul către Add-on-ul Subs.ro Plex Subtitle Downloader. (în mod normal nu trebuie schimbat)
secret	str		Parola folosită în câmpul webhook_secret din Add-on.

▶️ Utilizare Integrare

Opțiune	Metoda de activare	Descriere
Cleanup Orphaned Subtitles	Apăsare pe buton	Activare manuală a funcției de curățare subtitrări orfane ce nu mai au un fișier video asociat.
Download for Latest Video	Apăsare pe buton	Activare manuală a funcției de descărcare subtitrare pentru cel mai recent fișier video importat în Plex Media Server.
Download Missing Subtitles	Apăsare pe buton	Activare manuală a funcției de descărcare subtitrări pentru toate fișierele video ce nu au o subtitrare asociată.
Search & Download Subtitles	Introducere text în câmpul de căutare	Activare manuală a funcției de căutare și descărcare de subtitrări pentru fișierele video din librăria Plex Media Server pe baza cuvintelor cheie introduse în câmpul de căutare.
Search & Delete Subtitles	Introducere text în câmpul de căutare	Activare manuală a funcției de căutare și ștergere de subtitrări pentru fișierele video din librăria Plex Media Server pe baza cuvintelor cheie introduse în câmpul de căutare.
Status		Entitate de tip senzor ce permite vizualizarea statusului add-on-ului Subs.ro Plex Subtitle Downloader și acces facil la vizualizarea logului ultimei acțiuni făcute de către acesta. (Stări posibile: Offline, Booting, Idle, Processing)

📋 Exemplu de card pentru Dashboard

type: entities
entities:
  - entity: button.subs_ro_plex_subtitle_downloader_cleanup_orphaned_subtitles
    name: Cleanup Orphaned Subtitles
  - entity: button.subs_ro_plex_subtitle_downloader_download_for_latest_video
    name: Download for Latest Video
  - entity: button.subs_ro_plex_subtitle_downloader_download_missing_subtitles
    name: Download Missing Subtitles
  - entity: text.subs_ro_plex_subtitle_downloader_search_download_subtitles
    name: Search & Download Subtitles
  - entity: text.subs_ro_plex_subtitle_downloader_search_delete_subtitles
    name: Search & Delete Subtitles
  - entity: sensor.subs_ro_plex_subtitle_downloader_status
    name: Status
title: Subs.ro Plex Subtitle Downloader

🟢🟡🔴 Exemple de posibile rezultate în secțiunea Attributes a senzorului Status:

📦 Dependențe

🎬 X-Plex-Token

1. Conectează-te pe serverul tău Plex Media Server.
2. Apasă pe butonul ⋮ pe unul din obiectele din librărie și apoi pe opțiunea Get Info.

3. Apasă pe butonul View XML.

4. Copiază din bara de adresă a paginii care se deschide valoarea de la sfârșitul linkului, de după X-Plex-Token=.

5. Pune valoarea copiată în câmpul plex_token din Add-on.
6. Înapoi la secțiunea de configurare a Add-on-ului.

💬 API Token Subs.ro

1. Creează-ți cont pe Subs.ro.
2. Loghează-te și accesează pagina de profil.
3. Mergi la secțiunea Acces API și apasă pe butonul Generează o cheie API.

4. Copiază valoarea din secțiunea Cheia dumneavoastră API.

5. Pune valoarea copiată în câmpul subsro_api_key din Add-on.
6. Înapoi la secțiunea de configurare a Add-on-ului.

📜 Note de final ❤️

• Mulțumiri echipei Subs.ro pentru activarea API-ului! Fără acesta proiectul de față nu ar fi fost posibil. Mulțumiri, de asemenea, tuturor traducătorilor și sincronizatorilor! Logoul și subtitrările aparțin Subs.ro. 🙏
• Cod sursă al proiectului realizat în totalitate folosind Google Gemini. 🤖
• Dacă aveți idei de îmbunătățire sau doriți să semnalați probleme cu acest proiect, le aștept cu plăcere. 🤗
• Acesta este un proiect făcut din pasiune dar dacă îți place, îl găsești folositor și vrei să susții dezvoltarea lui pe viitor, dar și munca depusă până acum, o poți face printr-o contribuție scanând codul QR generat de Revolut de mai jos. Vă mulțumesc! 🫶