Risoluzione Problemi yt-dlp su Windows — Errori Comuni e Soluzioni

Causa: Il sito ha aggiornato la sua struttura e l'extractor di yt-dlp è obsoleto.

Soluzione: Esegui yt-dlp -U per ottenere gli ultimi extractor. Questa è la soluzione più comune per questo errore. Se persiste dopo l'aggiornamento, il sito potrebbe aver fatto una modifica importante — controlla la pagina delle issue GitHub per le segnalazioni.

Causa: FFmpeg non è installato o non è nel posto giusto.

Soluzione: Metti ffmpeg.exe nella stessa cartella di yt-dlp.exe. yt-dlp cerca lì per primo. Verifica con ffmpeg -version in PowerShell. Consulta la guida alla configurazione di FFmpeg.

Causa: PowerShell non riesce a trovare yt-dlp.exe perché la cartella non è nel PATH.

Soluzione — opzione 1: Naviga alla cartella contenente yt-dlp.exe in Esplora file, clicca sulla barra degli indirizzi, digita powershell e premi Invio. Esegui yt-dlp da lì.

Soluzione — opzione 2: Aggiungi la cartella yt-dlp al PATH. Consulta la guida all'installazione per le istruzioni passo dopo passo.

Causa: Il video richiede autenticazione o YouTube sta limitando la richiesta.

Soluzione: Prima aggiorna yt-dlp: yt-dlp -U. Se il video richiede il login, passa i cookie del browser: --cookies-from-browser chrome Sostituisci chrome con edge o firefox secondo necessità. Se usi una VPN, prova senza — alcuni nodi di uscita VPN sono bloccati da YouTube.

Causa: Throttling di rete, connessione instabile o limitazione della velocità da YouTube.

Soluzione: -N 4 --retries 10 --fragment-retries 10 --limit-rate 5M -N 4 abilita i download paralleli di frammenti. --limit-rate 5M limita la velocità per evitare reset di connessione. Prova a scaricare in un altro momento se YouTube sta limitando.

Causa: FFmpeg non è presente o è obsoleto.

Soluzione: Assicurati che ffmpeg.exe sia nella stessa cartella di yt-dlp.exe e sia un build recente. Aggiorna yt-dlp con yt-dlp -U. Poi riprova con: yt-dlp -f "bestvideo+bestaudio/best" "URL"

Causa: SmartScreen segnala gli eseguibili portatili non firmati per impostazione predefinita — è un falso positivo.

Soluzione: Clicca su Ulteriori informazioni → Esegui comunque. Il file è la release ufficiale non modificata di GitHub. Puoi anche cliccare con il tasto destro su yt-dlp.exe → Proprietà → spunta Sblocca in basso → OK.

Causa: Windows o l'antivirus ha bloccato il file scaricato da Internet.

Soluzione: Clicca con il tasto destro su yt-dlp.exe → Proprietà → spunta Sblocca → OK. Se l'antivirus lo blocca, aggiungi un'eccezione per il file. Scarica sempre dalla pagina ufficiale delle release GitHub.

Causa: L'archivio certificati di Windows è obsoleto, o un proxy/VPN sta intercettando HTTPS.

Soluzione: Aggiorna Windows (Impostazioni → Windows Update), poi riprova. Se sei dietro a un proxy aziendale, contatta il team IT. Come ultima risorsa solo: --no-check-certificate — non consigliato a lungo termine perché disabilita la validazione dei certificati.

Causa: Il sito non è supportato da yt-dlp, o il formato dell'URL è cambiato.

Soluzione: Aggiorna yt-dlp con yt-dlp -U. Controlla la lista dei siti supportati. Assicurati di usare l'URL corretto del video — gli URL di playlist e canale hanno formati diversi.