[BUG] Crunchyroll multiple problems

[Gianluke03]

ERROR 401:

Dopo l’ultimo commit, è stato risolto con successo il problema legato al download che causava l’errore 403 o alla gestione della key volatile.
Tuttavia, durante i test effettuati sul download di una season intera o di più episodi consecutivi, si presenta un nuovo errore HTTP 401 e finisce il processo dando questo errore:

Download: crunchyroll → Gachiakuta \ Risoluzione (S1E7)

Traceback (most recent call last):
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\test_run.py", line 25, in <module>
    main()
    ~~~~^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\run.py", line 499, in main
    run_function(input_to_function[category], search_terms=args.search)
    ~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\run.py", line 57, in run_function
    func(search_terms)
    ~~~~^^^^^^^^^^^^^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Template\loader.py", line 58, in __call__
    return self._search_func(*args, **kwargs)
           ~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Site\crunchyroll\__init__.py", line 152, in search
    result = process_search_result(select_title, selections)
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Site\crunchyroll\__init__.py", line 102, in process_search_result
    download_series(select_title, season_selection, episode_selection)
    ~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Site\crunchyroll\series.py", line 195, in download_series
    download_episode(i_season, scrape_serie, download_all=False, episode_selection=episode_selection)
    ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Site\crunchyroll\series.py", line 150, in download_episode
    path, stopped = download_video(index_season_selected, i_episode, scrape_serie)
                    ~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Site\crunchyroll\series.py", line 69, in download_video
    mpd_url, mpd_headers, mpd_list_sub = get_playback_session(client, url_id)
                                         ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Site\crunchyroll\util\get_license.py", line 116, in get_playback_session
    data = client.get_streams(url_id)
  File "C:\Users\UTENTE\Desktop\StreamingCommunity-main\StreamingCommunity\Api\Site\crunchyroll\util\get_license.py", line 87, in get_streams
    response.raise_for_status()
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "C:\Users\UTENTE\AppData\Local\Programs\Python\Python313\Lib\site-packages\curl_cffi\requests\models.py", line 167, in raise_for_status
    raise HTTPError(f"HTTP Error {self.status_code}: {self.reason}", 0, self)
curl_cffi.requests.exceptions.HTTPError: HTTP Error 401:

Comportamento attuale:

• Avviando il download di una serie completa (ad esempio una stagione da 12 episodi), il programma procede regolarmente per i primi episodi — ad esempio scarica correttamente i primi 2 o 3 episodi — ma poi si interrompe improvvisamente mostrando il seguente errore:

curl_cffi.requests.exceptions.HTTPError: HTTP Error 401

Problemi relativi a sottotitoli e tracce audio:

• All’avvio di qualsiasi download — anche se nei file di configurazione è correttamente impostato it-IT (secondo la nomenclatura di Crunchyroll per lingua e tipo di sottotitoli) — non sempre vengono scaricati i sottotitoli corretti.
  In diversi casi vengono inclusi solo i “dialoghi” o solo i “cartelli”, ma non entrambi o non quelli effettivamente selezionati.

• Nella sezione degli “available” mostrata nella descrizione in alto, non vengono visualizzate tutte le tracce audio e i sottotitoli realmente disponibili per la serie o l’episodio.

• Inoltre, quando il video scaricato viene aperto con un player diverso da VLC, le tracce dei sottotitoli non vengono riconosciute o lette correttamente.
  All’interno del file, inoltre, non viene mantenuto il font originale dei sottotitoli di Crunchyroll, che invece dovrebbe restare incorporato nel flusso per una corretta visualizzazione dello stile del testo.

Dubbio (incerto) sull'audio:

• L’audio finale risulta un po’ piatto, ma probabilmente ciò è dovuto al fatto che viene ripacchettizzato in formato MP4.
  Forse, potendo ripacchettizzare il tutto in MKV, si potrebbe risolvere o almeno migliorare la resa audio.
  Non so se sia possibile modificare questo aspetto all'interno del programma ma sarebbe utile poterlo fare anche solo aggiungendo un file config più modulare o dedicato a quest'ultima per regolare questi aspetti che fanno la differenza in un file video.

Come osservazione extra:

• Ho notato che in alcune serie più lunghe con più stagioni— ad esempio One Piece, nella stagione 14
  il comportamento è ancora più particolare😅:
  anche se risultano visualizzabili fino alla stagione 19, alcune non possono essere scaricate perché non hanno effettivamente un numero di stagione valido (es. S15, S16, ecc.), oppure vengono mostrate in modo incompleto.
  Nel caso specifico della stagione 14, viene visualizzata e scaricata solo la prima parte ed arrivando nel particolare all'episodio finale della prima parte della stagione 14 visualizzabile nei download segna "No video found", mentre la seconda parte, che porta lo stesso numero di stagione, non viene riconosciuta o resa disponibile per il download.

PS:
ho provato anche con altre serie, diverse dalle solite due (Gachiakuta e Solo Leveling), con o senza la sessione Google attiva sulla pagina, ma il problema si ripresenta sempre allo stesso modo: dopo un certo numero di download consecutivi viene restituito l’errore 401.

[Gianluke03]

@Arrowar
Scusami per l’insistenza, ma ho rivisto la parte che ho scritto riguardante i "Dubbi (incerti) sull’audio": sarebbe bello poter, quanto possibile, avere la possibilità di modulare quei piccoli aspetti legati al modo in cui il file video viene ripacchettizzato nel risultato finale ad esempio permettendo di scegliere un MKV invece di un MP4.

E spero sia possibile risolvere anche i problemi relativi ai config che non ho citato, pensando fossero di poca importanza.
Sarebbe utile specificarlo per i prossimi: se non viene utilizzata la nomenclatura o il formato esatto fornito da Crunchyroll, ad esempio “it-IT”, questi config non vengono mai presi in considerazione durante il download.

[Arrowar]

Per questi ci vorrà un bel po' di tempo in più. Nel mentre riusciresti ad elencare tutti i problemi dal primo fino all'ultimo.

Gli elenchi di problemi mi vengono più facili da ordinare in base alla difficoltà

[Gianluke03]

@Arrowar

N°	Problema	Dettaglio	Difficoltà
1	Errore 401	Durante i download multipli (stagioni o più episodi consecutivi) il processo si blocca mostrando HTTP Error 401. Il problema si manifesta dopo alcuni episodi, probabilmente per scadenza del token o mancato refresh della sessione.	Alta
2	Sottotitoli / tracce audio mancanti o errate (3 step in 1)	I sottotitoli scaricati non corrispondono sempre alla lingua o al tipo selezionato nel file di configurazione (it-IT). In alcuni casi vengono inclusi solo dialoghi o solo cartelli. Inoltre, il font originale di Crunchyroll non viene mantenuto (neanche letto dal player VLC) e su alcuni player, se si usa un player diverso da VLC, i sottotitoli non vengono riconosciuti per nulla. Succede la stessa cosa con il tipo di audio che viene rinominato non nel modo giusto esempio audio in Italiano viene rinominato come eng (Inglese) anche se alla fine l'audio è in lingua Italiana.	Alta
3	Qualità audio ridotta	L’audio finale risulta “piatto” dopo il repack, probabilmente per la ricodifica o compressione in MP4. Sarebbe utile poter impostare il formato di output (es. MKV) o rendere il file config più modulare o un'altro file separato di config per gestire meglio le opzioni di muxing/compressione.	Media
4	Serie lunghe / stagioni incomplete	Alcune serie (es. One Piece) risultano parziali: solo parte della stagione viene scaricata, mentre la seconda parte o altre stagioni con numerazione simile generano errore “Video not Found”. Il problema sembra legato alla gestione degli ID stagionali o alla divisione interna in sotto-stagioni.	Media
5	Lista “available” incompleta	Le informazioni “available” (viste a schermo una volta che inizia il download) non mostrano tutte le tracce audio e i sottotitoli realmente disponibili per la serie o l’episodio. Ciò può causare una selezione errata o incompleta. Il parsing delle API sembra parziale o limitato.	Media
6	Lettura poco chiara del file config per scaricare e indirizzare il tipo di lingua dei Dialoghi e Sottotitoli	Se non viene utilizzata la nomenclatura o il formato esatto fornito da Crunchyroll, ad esempio “it-IT”, questi config non vengono mai presi in considerazione durante il download, scaricando sempre (suppongo) quelli impostati in precedenza come predefiniti dall'utente, se non trovati dal file config.	Bassa

[Gianluke03]

Ho perso un po’ di tempo a mettere in lista tutto quello che ho osservato durante i test di questo ultimo pomeriggio 😅, spero possa esservi utile per raggruppare tutte le idee in un unico posto.

Ho provato a scaricare una serie intera e, anche dopo diversi test con la sessione Google attiva o meno, l’errore 401 continua a presentarsi dopo alcuni download consecutivi.

Ho provato a nominare il file di configurazione nella sezione dei sottotitoli anche come forced. Tuttavia, il programma tende a scaricare maggiormente i “cartelli” e non i dialoghi completi, indipendentemente dalla configurazione impostata su it-IT.

[Gianluke03]

Aggiornamento test download — anomalie riscontrate

Vorrei condividere un pò delle prove visive citate prima nel primo commento per dare un'idea e a parte delle nuove che ho trovato, che spero possano esservi utili. 🔎

• Negli ultimi test sono emersi diversi comportamenti anomali durante il download delle serie da Crunchyroll.
  Alcune serie vengono saltate del tutto, altre presentano inconsistenze nei flussi disponibili (video/audio/sub), e in certi casi ci sono difficoltà nella ricerca o identificazione delle stagioni.

Caso 1 – Comportamento quasi corretto (di riferimento)

Piccola congettura:
Nello specifico di questo episodio, il test ha restituito tutte le informazioni Available (video, audio, sottotitoli). Probabilmente ciò è dovuto al fatto che, sebbene l’episodio sia parte di una “season” secondo Crunchyroll, si trova come singolo episodio isolato all’interno della struttura del catalogo (Suppongo, ma è molto probabile che mi sbagli su questo punto).

• Rilevamento completo dei flussi disponibili e download regolare, anche se metto in dubbio la ripacchettizzazione del file video che perde un po' di qualità (penso sempre dovuta al tipo di compressione del file in MP4).

• Si può notare inoltre una ripetizione delle tracce audio disponibili, che approfondisco più avanti nel Caso 3.

Serie: SPY x FAMILY
Episodio: S3E1 – “Berlint Panic / L’informatore e Nightfall”

Download: crunchyroll → SPY x FAMILY \ Berlint Panic / L'informatore e Nightfall (S3E1)

You can safely stop the download with Ctrl+c
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ Type       ┃ Available                                                        ┃ Set               ┃ Downloadable   ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ Video      │ 1920x1080, 1280x720, 854x480, 640x360, 426x240                   │ Best              │ 1920x1080      │
│ Audio      │ ja-JP, ja-JP, ja-JP                                              │ First             │ ja-JP          │
│ Subtitle   │ en-US, de-DE, es-419, es-ES, fr-FR, it-IT, pt-BR, ru-RU, ar-SA   │ ita, it-IT, eng   │ it-IT          │
└────────────┴──────────────────────────────────────────────────────────────────┴───────────────────┴────────────────┘

DASH Video: ████████████████████████████████████████ 356/356 TS [00:26 < 00:00] , 907.74 MB @ 50.03 MB/s
DASH Audio ja-JP: ████████████████████████████████████████ 356/356 TS [00:09 < 00:00] , 33.76 MB @ 9.29 MB/s
FFMPEG Join audio: ('speed': 1.89e+03x, 'size': 922.95 MB)
FFMPEG Join subtitle: ('speed': 1.34e+03x, 'size': 922.99 MB)

Caso 2 – Serie completamente saltata ("No video found")

• Il programma salta tutti gli episodi della stagione seguente come se non trovasse nessun flusso video.

Serie: To Your Eternity
Episodio: S1E13 – “La volontà di migliorarsi”

Download: crunchyroll → To Your Eternity \ La volontà di migliorarsi (S1E13)

You can safely stop the download with Ctrl+c
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ Type       ┃ Available   ┃ Set               ┃ Downloadable   ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ Video      │ Nothing     │ Best              │ N/A            │
│ Subtitle   │ it-IT       │ ita, it-IT, eng   │ it-IT          │
└────────────┴─────────────┴───────────────────┴────────────────┘

No video found

Caso 3 – Informazioni “Available” parziali o ripetute

• le lingue audio vengono duplicate (es. it-IT, it-IT, it-IT) e risultano mancanti altre tracce normalmente disponibili, come già segnalato all'inizio dell'issue: questo evidenzia che lo script non rileva correttamente tutte le tracce audio o i sottotitoli effettivamente presenti per l’episodio.

Serie: JUJUTSU KAISEN
Episodio: S1E2 – “Per me stesso”

Download: crunchyroll → JUJUTSU KAISEN \ Per me stesso (S1E2)

You can safely stop the download with Ctrl+c
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ Type       ┃ Available                                        ┃ Set               ┃ Downloadable   ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ Video      │ 1920x1080, 1280x720, 854x480, 640x360, 426x240   │ Best              │ 1920x1080      │
│ Audio      │ it-IT, it-IT, it-IT                              │ it-IT             │ it-IT          │
│ Subtitle   │ it-IT                                            │ ita, it-IT, eng   │ it-IT          │
└────────────┴──────────────────────────────────────────────────┴───────────────────┴────────────────┘

DASH Video: ██████████████████                       163/360 TS [00:11 < 00:11] , 990.14 MB @ 51.74 MB/s

Caso 4 – Problemi di riconoscimento della serie e delle stagioni

• Come altro esempio dei problemi di riconoscimento, come visto con One Piece Season 14, lo stesso comportamento si verifica anche con Demon Slayer: Kimetsu no Yaiba.

• La serie viene trovata, ma le stagioni non hanno numerazione (solo nomi).
  Inserendo il numero della stagione, lo script restituisce errore perché non trova un ID associato.

┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┓
┃ Index ┃                      Name                      ┃ Type ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━┩
│   0   │         Demon Slayer: Kimetsu no Yaiba         │  tv  │
│   1   │ Demon Slayer: Kimetsu no Yaiba Infinity Castle │  tv  │
│   2   │               Demon Lord, Retry!               │  tv  │
│   3   │               Demon King Daimao                │  tv  │
│   4   │                DEMON LORD 2099                 │  tv  │
│   5   │         Yashahime: Princess Half-Demon         │  tv  │
│   6   │        The Misfit of Demon King Academy        │  tv  │
│   7   │       Welcome to Demon School! Iruma-kun       │  tv  │
│   8   │       The Demon Prince of Momochi House        │  tv  │
│   9   │      Sleepy Princess in the Demon Castle       │  tv  │
└───────┴────────────────────────────────────────────────┴──────┘

Press Enter for next page, 'q' to quit, or 'back' to search.
Insert media index: 0

Seasons found: 4

Insert season number (e.g., 1), * to download all seasons, (e.g., 1-2) for a range of seasons, or (e.g., 3-*) to
download from a specific season to the end: 3
[ScrapeSerie.py:108 - _fetch_episodes_for_season() ] 2025-10-10 04:05:53,747 - ERROR - Season 3 not found or missing id.
No episodes found for season 3

Screenshot dell’elenco delle stagioni disponibili sul sito.
.

PS:
durante tutti i test mi sono sempre accertato della validità delle chiavi di sessione (device_id, etp_rt), verificando il funzionamento sia con la scheda Google aperta sulla pagina di Crunchyroll sia senza.

[Arrowar]

Con la nuova versione il problema 1 che riguarda 401 dovrebbe essere stato risolto.
Anche il problema 4 che riguardava le stagioni che non venivano selezionate correttamente dovrebbe essere stato risolto.

[Gianluke03]

Perfetto, grazie mille adesso ci do un'occhiata

[Gianluke03]

Post aggiornamento 3.3.9

Niente da fare: presenta ancora quasi tutti i problemi citati in precedenza, anche se con qualche miglioramento.

Dopo un certo numero di esecuzioni, ora il programma non mostra più errori ma va direttamente in crash.

Più tardi proverò con il codice sorgente, anche se non so quanto possa cambiare, e pubblicherò un aggiornamento con tutti i problemi riscontrati, così da capire meglio com’è cambiata la situazione rispetto a prima.

o addirittura per i sottotitoli in alcuni li trova ma vengono rinominati così:

Download: crunchyroll → To Your Eternity \ L'ultimo individuo (S1E1)

You can safely stop the download with Ctrl+c
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ Type       ┃ Available                                        ┃ Set               ┃ Downloadable   ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ Video      │ 1280x720, 1920x1080, 854x480, 640x360, 426x240   │ Best              │ 1920x1080      │
│ Audio      │ aud_f1-a1-x3, aud_f3-a1-x3, aud_f4-a1-x3         │ First             │ aud_f1-a1-x3   │
│ Subtitle   │ it-IT                                            │ it-IT, ita, eng   │ it-IT          │
└────────────┴──────────────────────────────────────────────────┴───────────────────┴────────────────┘

DASH Video: ███████████████████████▊                 224/376 TS [00:09 < 00:07] , 754.72 MB @ 57.72 MB/s

Oppure, come in precedenza, non vengono visualizzati tutti i sottotitoli e gli audio disponibili per alcuni titoli. Anche provando a forzare nel file config un audio diverso (ad esempio jp-JP) o modificando i sottotitoli, non cambia nulla: i sottotitoli scaricati (anche quelli it-IT) non contengono i dialoghi, ma solo cartelli o scritte a schermo — lo stesso problema già citato in precedenza.

[Arrowar]

Si il problema è che nel manifest gli audio non hanno una lingua. E almeno io non so come facciano a capire quale _id corrisponde ad una lingua. È il primo sito con un manifest incompleto

[Gianluke03]

Peccato davvero per questo piccolo difettuccio, perché avere un downloader del genere è già fantastico — riuscire a migliorarlo al 100% sarebbe un sogno!
Comunque, se riesco, provo anch’io a portare avanti la ricerca: farò diversi test nel pomeriggio (anche dal codice sorgente aggiornato) per vedere se emergono nuove problematiche e capire come tamponare quelle precedenti.

[Arrowar]

Grazie mille se riesci.

Il codice che ho scritto non dovrebbe essere troppo complicato da capire, almeno spero che sia così.

[Gianluke03]

@Arrowar

Aggiornamento: 401 + audio/sottotitoli + stagioni — cause, fix e stato

Premessa (perché capitava il 401 e perché ci ho messo 3 settimane)

Dopo 3 settimane di test su più serie, ambienti e orari, la conclusione è che il 401 non dipende da chiavi/DRM errati, ma da come sono gestite le chiamate in sequenza nei download multipli (stagioni o batch di episodi). Il problema esplode dopo i primi episodi, segnale tipico di:

Burst di richieste (search/CMS/playback) → il server attiva rate-limit e risponde con 401/420/429.
Token vicino alla scadenza durante il batch → il refresh non avveniva con sufficiente anticipo.
Sessioni di playback non chiuse → ogni episodio lasciava uno stream aperto; dopo un po’ CR rifiuta nuove sessioni.
Discovery audio/subtitle troppo verbosa su manifest eterogenei → più round-trip, più probabilità di rate-limit.
Variabilità per serie/regione/manifest → alcuni manifest non espongono la lingua audio, costringendo a fallback (altre chiamate).

---

Aggiornamento lato downloader Crunchyroll

Lascio uno script stand-alone di test (main.py) + requirements.txt + README per simulare e analizzare il flusso CR (auth → CMS → playback → chiusura sessione → merge audio/sub).
Con questo possiamo riprodurre i problemi e validare i fix, poi portarli definitivamente nel downloader:

Scraping_Crunchyroll.zip

• Pacing con QPS configurabile + backoff su 401/502/503/504.
• Refresh proattivo del token quando sta per scadere, con fallback a re-login.
• Chiusura esplicita della sessione di playback per episodio (delete token).
• Merge reale di audio/sub da tutte le versioni audio (quando presenti) e classificazione sub cc/signs/dialogue.
• Seasons: selezione deterministica con normalizzazione opzionale (1..N, cr_number preservato).

---

Come usare lo script di test

1) Installazione

pip install -r requirements.txt

Requisiti principali:

curl_cffi
tqdm
ua-generator

2) Configurazione (config.json)

Compila SITE_LOGIN.crunchyroll.device_id ed etp_rt validi.
Imposta la ricerca o un series_id. Esempio minimo (coerente con i test):

il config completo con public_token è nella cartella

{
  "SITE": {
    "base_url": "https://www.crunchyroll.com",
    "public_token": ""
  },
  "SITE_LOGIN": {
    "crunchyroll": {
      "device_id": "",
      "etp_rt": ""
    }
  },
  "REQUESTS": {
    "timeout": 30,
    "impersonate": "chrome110",
    "qps": 5.0,
    "max_retries": 3,
    "base_backoff_ms": 300,
    "slowdown_after": 50,
    "default_user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
  },
  "DEFAULTS": {
    "locale": "it-IT",
    "preferred_audio_language": "it-IT",
    "search_limit": 25,
    "throttle_ms": 0
  },
  "RUN": {
    "log_level": "INFO",

    "series_id": null,
    "search": "demon slayer",
    "pick": 0,
    "list_results": false,

    "locale": "it-IT",
    "prefer_audio": "it-IT",

    "progress": true,
    "checkpoint": "checkpoint.json",

    "qps": 5.0,
    "throttle_ms": 0,
    "normalize_season_numbers": false
  }
}

3) Esecuzione

python main.py

• Lo script produce sempre un JSON completo su stdout.
• Se RUN.progress=true vedrai barre tqdm.
• Se RUN.checkpoint è impostato, scrive snapshot incrementali coerenti per riprendere/diagnosticare.
• Per imitare meglio l’uso reale e mitigare rate-limit:
  • RUN.qps = 3.0–5.0
  • RUN.throttle_ms = 250 (serie “pesanti”)

4) Verifiche consigliate

401/420/429
Riduci QPS, attiva backoff (già incluso), verifica che i log mostrino refresh token prima del playback.

Audio/sottotitoli
Controlla in output.json che:

• audio_locales e watch_urls_by_audio contengano tutte le versioni disponibili;
• le tracce subtitles siano etichettate cc / signs / dialogue come previsto;
• subtitles_declared (da CMS) e quelle reali (da playback) coincidano o evidenzino lacune del manifest.

Seasons
Se la numerazione CR è “strana”, imposta normalize_season_numbers = true per usare 1..N e mantenere cr_number in output.

---

Cosa cambia nel merito dei problemi dell’issue

401 nei batch lunghi

• Pacing QPS + backoff, refresh proattivo, chiusura sessione di playback per episodio → il batch non “muore” al 2°/3° episodio.

Audio/Sottotitoli mancanti o “solo cartelli”

• Merge guid-base + tutte le versioni audio; classificazione sub cc/signs/dialogue; uso combinato CMS + playback.
• Se il manifest non espone lingua audio (etichette tipo aud_f1-a1-x3), serve una tabella locale {track_id → locale} per la serie (proposta: salvare nel checkpoint).

“Available” parziale/duplicato

• Ora deriva da CMS (declared) + playback (reale) + versioni aggiuntive.
• I duplicati per locale spesso sono encodes diversi → a UI mostrare locale una sola volta e gli encodes come dettaglio.

Serie lunghe / stagioni incomplete

• Selezione deterministica + normalizzazione opzionale → si evita di “perdere” sotto-stagioni o numerazioni non contigue.

---

Caso limite: One Piece (Season 14 sdoppiata)

In One Piece la Season 14 risulta sdoppiata in due parti con lo stesso numero CR ma titoli diversi.
Questo può confondere la selezione “per numero”. In pratica si risolve così:

Opzione A (consigliata): lascia normalize_season_numbers = false e seleziona la parte corretta in base al titolo (o allo slug) della stagione, usando il cr_number solo come riferimento.
Opzione B: se usi normalize_season_numbers = true, in output hai comunque cr_number → discrimina le due parti con titolo + cr_number.
Opzione C (robusta lato codice): nelle UI/CLI, quando CR presenta più stagioni con lo stesso numero, mostra entrambe le voci e fai scegliere per titolo; in alternativa, applica un semplice mapping locale {(cr_number, title) → season_id}.

Con questa gestione, il resto funziona correttamente.

PS

Scusate se lo script può risultare un po’ difficile da leggere: non sono un esperto del settore e ho impiegato tempo anche solo per studiare l’argomento; è uno dei motivi per cui mi ci sono volute settimane per arrivare a questo risultato.

Grazie per tutto quello che fate e spero di poter dare un contributo a questo progetto.

⚠️ WARNING (uso e responsabilità – versione dettagliata)

• Solo test personali / finalità didattiche. Questo materiale è fornito esclusivamente per scopi di studio e diagnostica. Non è destinato all’uso produttivo, commerciale o alla distribuzione di contenuti.
• Termini di Servizio & leggi vigenti. L’uso contro i ToS di Crunchyroll o in violazione di normative locali/internazionali è vietato. La manomissione di misure tecniche di protezione (TPM/DRM) può essere illegale (es. DMCA §1201, Direttiva 2001/29/CE e recepimenti nazionali). Non utilizzare per eludere paywall, geo-restrizioni o limitazioni d’account.
• Rischi per l’account e la rete. Automazioni/scraping possono attivare sistemi anti-abuso: ban IP, revoca token, sospensione/chiusura account, blocchi per “troppi stream attivi”. L’uso su reti aziendali o condivise può violare policy interne: chiedi autorizzazione agli amministratori prima di procedere.
• Dati sensibili & sicurezza. etp_rt, device_id, token di playback e cookie sono segreti.
  • Non committarli in repository pubblici; usa file esclusi dal VCS (.gitignore) o variabili d’ambiente.
  • Sanitizza i log (niente token/ID in chiaro).
  • Se sospetti una fuga di credenziali: revoca/ruota i token e rigenera gli identificativi di dispositivo.
• Rispetto dell’infrastruttura. Mantieni un rate limit conservativo (QPS basso), evita parallelismi aggressivi, introduci backoff. Carichi eccessivi possono degradare il servizio e aumentare il rischio di blocchi/401/420/429.
• Diritti sui contenuti. Non scaricare, archiviare, ricondividere o rimuxare contenuti senza i diritti necessari. Verifica sempre licenze e consensi prima di qualunque utilizzo ulteriore dei materiali.
• Nessuna garanzia. Script e documentazione sono forniti “as is” senza garanzie espresse o implicite; declino ogni responsabilità per danni, perdita di dati, sospensioni d’account o conseguenze legali derivanti dall’uso.
• VPN/Proxy & geolocalizzazione. L’uso di VPN/proxy per cambiare area potrebbe violare ToS e/o leggi locali. Procedi solo se pienamente conforme.
• Reverse engineering. Questo lavoro non è inteso per aggirare sistemi DRM, ma per diagnostica delle chiamate API e delle discrepanze di catalogo/manifest. Non utilizzare per rimuovere o indebolire protezioni tecniche.
• Contributi pubblici. In issue/PR allega solo log anonimizzati (senza token/cookie/ID personali) e mai spezzoni di contenuti protetti da copyright.