yt-dlp: La versione moderna di youtube-dl per il download di video

yt-dlp: La versione moderna di youtube-dl per il download di video

Il 23 ottobre 2020, la Recording Industry Association of America ha presentato una richiesta di rimozione DMCA contro youtube-dl su GitHub. Tre giorni dopo, il 26 ottobre, è apparso silenziosamente un nuovo repository all'indirizzo github.com/yt-dlp/yt-dlp. Quando GitHub ha ripristinato il progetto originale il 16 novembre, insieme a un nuovo fondo di difesa per gli sviluppatori di 1 milione di dollari, il nuovo fork aveva già iniziato ad assorbire i collaboratori di youtube-dl.

Quella versione è ora quella principale. A maggio 2026, yt-dlp registrava oltre 12 milioni di download al mese su PyPI. Il suo repository GitHub contava 160.766 stelle. Il progetto rilascia una nuova versione all'incirca ogni due settimane. L'ultima versione, al momento della stesura di questo testo, è la `2026.03.17`. Supporta più di 1.800 siti di video e audio tramite il suo sistema di plugin di estrazione. Quella che segue è una panoramica completa di cos'è yt-dlp e di come usarlo. Inoltre, qual è la sua situazione legale nel 2026 e perché un'installazione perfettamente funzionante potrebbe improvvisamente smettere di funzionare a metà del 2025.

Da dove proviene yt-dlp: dalla catena di fork di youtube-dl

La discendenza è importante in questo caso perché spiega una discrepanza comportamentale. yt-dlp rilascia correzioni entro poche ore da un'interruzione di YouTube; youtube-dl può impiegare settimane. Tre progetti si trovano nell'albero genealogico e ogni passo è stato guidato dalla frustrazione per il precedente.

youtube-dl è stato il progetto originale. Ricardo García lo scrisse nell'agosto del 2006 e in seguito Philipp Hagemeister lo guidò con un gruppo ristretto sotto il nome di `ytdl-org/youtube-dl`. Nel 2020 era diventato di fatto lo strumento di archiviazione, ma le pull request si accumulavano e le correzioni di YouTube arrivavano in ritardo.

Quella lacuna è ciò che ha prodotto youtube-dlc, dove la "c" stava per "community". `blackjack4494` ha effettuato un fork del repository nel 2020 e la coda di merge si è svuotata in pochi giorni. Il fork stesso è diventato semi-inattivo verso la fine dello stesso anno: uno dei manutentori è instabile.

yt-dlp è un refork di youtube-dlc. Il repository è stato creato il 26 ottobre 2020, tre giorni dopo la rimozione di youtube-dl da parte della RIAA. yt-dlp è uno strumento da riga di comando che permette di scaricare video e audio da siti web supportati. La "p" indica uno dei primi manutentori principali (`pukkandan`). Il progetto è ora gestito da un'organizzazione multi-manutentore che include `coletdjnz`, `dirkf`, `Grub4K`, `bashonly` e `seproDev`. Entro gennaio 2021 yt-dlp aveva assorbito la base di contributori di youtube-dlc. Era diventato il fork dominante di youtube-dl. L'attenzione si è concentrata su funzionalità e miglioramenti che la versione originale non aveva ancora integrato.

Alcuni fatti a livello di progetto meritano di essere segnalati. yt-dlp utilizza il versionamento a calendario, quindi un tag come `2026.03.17` indica letteralmente la data di rilascio. La licenza è The Unlicense, una dichiarazione esplicita di pubblico dominio che nemmeno la maggior parte dei progetti FOSS utilizza. Il repository ha 13.348 fork e 2.507 problemi aperti. Ubuntu 22.04 ha sostituito youtube-dl con yt-dlp come downloader video predefinito, e Debian ha seguito l'esempio con bookworm. L'elenco dei siti supportati in `supportedsites.md` attualmente elenca più di 1.500 voci nominate; il codice sorgente stesso include circa 1.800 moduli di estrazione con caricamento differito. Arch, Fedora, NixOS, Homebrew, Chocolatey, Scoop e Winget lo includono tutti. Venti o trenta rilasci all'anno sono ciò che ha impedito alle distribuzioni di tornare alla versione upstream più lenta.

yt-dlp

Come la chiusura imposta dalla RIAA nel 2020 ha reso inevitabile yt-dlp

La notifica DMCA della RIAA del 23 ottobre 2020 è stata presentata ai sensi del 17 USC § 1201, la clausola anti-elusione. La sua tesi era che youtube-dl aggirasse il meccanismo di firma "rolling cipher" di YouTube, che la RIAA ha definito una misura tecnologica a protezione dell'accesso alle opere protette da copyright. Inizialmente GitHub si è conformato e ha rimosso il repository insieme a diciassette fork.

Ciò che seguì fu un classico effetto Streisand. Gli sviluppatori ripubblicarono il codice sorgente in modi sempre più fantasiosi, incluso un'immagine su Twitter i cui colori dei pixel codificavano l'intero codice. L'Electronic Frontier Foundation inviò una lettera a GitHub il 16 novembre 2020. La sua argomentazione tecnica era semplice: una firma che qualsiasi browser conforme agli standard può eseguire non è una "misura tecnologica che controlla effettivamente l'accesso" ai sensi del § 1201. youtube-dl utilizza la firma; non la viola.

GitHub ha ripristinato il repository lo stesso giorno. Ha inoltre promesso un fondo di difesa per gli sviluppatori di 1 milione di dollari e si è impegnato a effettuare una revisione tecnica e legale manuale di ogni rimozione ai sensi della Sezione 1201 in futuro. L'episodio ha catalizzato la creazione di yt-dlp. Il repository del nuovo fork appare nella cronologia dei commit tre giorni dopo la rimozione. Nessuno sapeva ancora se GitHub avrebbe fatto marcia indietro. Gli sviluppatori volevano una garanzia.

Installa yt-dlp su Windows, macOS e Linux.

Spesso ci si dimentica la seconda parte dell'installazione e poi ci si chiede perché la fase di unione si blocchi. Certo, yt-dlp da solo può scaricare un singolo flusso da qualsiasi sito supportato. Ma il miglior video più il miglior audio? Capitoli incorporati? Un remux mp4? Tutto questo viene gestito automaticamente da `ffmpeg` e `ffprobe`. Saltate questi due programmi e il vostro primo tentativo con `bv*+ba/b` stamperà qualcosa di criptico e si interromperà. Quindi: installateli entrambi, sempre.

Per Windows consiglio Winget. `winget install yt-dlp.yt-dlp`, poi `winget install Gyan.FFmpeg`. Scoop funziona se lo usi già; anche Chocolatey. Se un gestore di pacchetti ti sembra eccessivo, il programma standalone `yt-dlp.exe` si trova su GitHub Releases: basta copiarlo in una cartella, aggiungere la cartella al PATH e il gioco è fatto.

Gli utenti Mac possono usare la versione più semplice: `brew install yt-dlp ffmpeg`. Una sola riga. E il gioco è fatto.

Linux varia a seconda della distribuzione. L'archivio principale di Debian lo include. Arch lo mantiene in `extra`. Fedora lo scarica tramite i canali standard. Il problema è la tempistica: quando si verifica un bug in YouTube, le versioni delle distribuzioni tendono ad essere in ritardo di giorni. La soluzione è l'installazione di Python, che è il modo migliore per scaricare i video il giorno stesso in cui viene rilasciata una correzione: `python -m pip install -U yt-dlp` su qualsiasi sistema con Python 3.9 o versioni successive. Questa riga esegue anche l'aggiornamento sul posto. L'opzione curl e chmod è ancora presente nella documentazione (`sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod +x /usr/local/bin/yt-dlp`), ma è consigliabile utilizzarla solo se non esiste un'opzione tramite gestore di pacchetti.

Dopo l'installazione, `yt-dlp -U` aggiorna le copie di pip e dei binari; salta intenzionalmente le copie del gestore di pacchetti. Scegli un metodo di installazione e attieniti ad esso. L'abbinamento di ffmpeg e ffprobe è imprescindibile.

Comandi base di yt-dlp che userai effettivamente

Il foglio riassuntivo minimo è breve. Il comando base, `yt-dlp URL`, funziona solo nel caso più comune. Tutto il resto richiede uno o due flag.

Prima di scaricare un video da YouTube, esegui `yt-dlp -F URL` per vedere quali formati sono disponibili. L'output elenca tutti i formati video, tutti i flussi audio e tutti i flussi pre-uniti trovati dall'estrattore, insieme ai codec e alle dimensioni dei file. La maggior parte degli utenti passa quindi direttamente a `yt-dlp -f "bv*+ba/b" URL`. Questo selettore significa "miglior video più miglior audio, fallo fallo con il miglior flusso combinato se i due non sono separati". È la sintassi di selezione del formato principale di yt-dlp e vale la pena memorizzarla. Aggiungi `--merge-output-format mp4` per forzare il contenitore; aggiungi `-x --audio-format mp3` per solo l'audio. Per i sottotitoli, `--write-subs --sub-langs en` scarica quelli ufficiali, mentre `--write-auto-subs` fallisce fallo fallo con la traccia generata automaticamente se non ce n'è una creata da un operatore.

Per gli elenchi, `-a urls.txt` legge un URL per riga ed è il metodo standard per scaricare più video in una singola esecuzione. Il flag `--playlist-items 1-10,15,20-` suddivide una playlist. E `--download-archive seen.txt` mantiene un registro dei download completati, in modo che le esecuzioni successive saltino ciò che è già presente. L'archivio di download è il modo più pulito per scaricare intere playlist e canali in modo incrementale senza doverli scaricare nuovamente. La denominazione dei file di output segue un modello. La stringa `-o "%(channel)s/%(upload_date>%Y-%m-%d)s — %(title)s.%(ext)s"` produce nomi di file datati e raggruppati per canale nella cartella scelta. Il risultato è compatibile con le librerie Plex e Jellyfin. Il flag `-P` cambia la directory di destinazione. Il flag `--restrict-filenames` mantiene i nomi in formato ASCII per la sicurezza tra filesystem diversi. E `--print filename` mostra in anteprima cosa scriverebbe yt-dlp prima dell'inizio del processo di download.

Se un download viene riprodotto anziché scaricato, significa che il browser apre il link prima che yt-dlp lo rilevi. Passa l'URL come argomento letterale o racchiudilo tra virgolette ed esegui yt-dlp dal terminale.

Funzionalità avanzate: post-processori, SponsorBlock, cookie

Oltre alle funzionalità di base, yt-dlp possiede una superficie di funzionalità sorprendentemente ampia. I flag elencati di seguito sono quelli più importanti nella pratica.

Categoria Bandiera Utilizzo
Ordinamento formato `-S "+size,+br,res:1080"` Preferisci file di dimensioni ridotte a 1080p
Post-elaborazione `--embed-thumbnail --embed-metadata --embed-chapters --embed-subs` Incorpora nel file illustrazioni, tag, capitoli e sottotitoli
Blocco sponsor `--sponsorblock-mark all` / `--sponsorblock-remove sponsor,selfpromo` Contrassegna o taglia le sezioni degli sponsor nei video di YouTube
Autenticazione `--cookies-from-browser firefox` Utilizza i cookie del tuo browser; supporta Chrome, Brave, Edge, Safari, Opera, Vivaldi, Chromium, Whale
Registrazione dal vivo `--live-from-start --hls-use-mpegts` Registra la diretta streaming dall'inizio, anche se ti unisci in ritardo
Velocità `--concurrent-fragments 8` Download paralleli di frammenti HLS o DASH
Downloader esterno `--downloader aria2c` Trasferimenti manuali ad aria2c per il parallelismo
Plugin `~/.yt-dlp/plugins/` Estrattori e post-processori personalizzati da integrare

L'integrazione con SponsorBlock è utile. L'opzione attinge al database della community di SponsorBlock. Consente di contrassegnare i marcatori di capitolo o di eliminare completamente le sezioni degli sponsor nei video di YouTube. L'opzione `--cookies-from-browser` legge i cookie dai profili del browser, inclusi i contenitori di Firefox, ed è il modo più pulito per scaricare contenuti protetti da paywall o che richiedono l'accesso tramite login. Per terabyte di archivi di lunga durata, il passaggio del downloader esterno ad aria2c aumenta sensibilmente la velocità di download su reti in cui la finestra TCP rappresenta il collo di bottiglia. Inoltre, `--split-chapters` suddivide il contenuto video per capitolo in file separati, il che è utile quando un singolo caricamento raggruppa diverse presentazioni. yt-dlp supporta anche `--video-multistreams` per combinare le tracce video laddove il sito ne fornisca più di una, sebbene questa sia una situazione rara.

Il sistema di plugin merita una riga a parte. yt-dlp rileverà automaticamente i moduli Python posizionati in `~/.yt-dlp/plugins/` (o installati tramite `pip` con il punto di ingresso `yt-dlp-plugins`) e li caricherà come estrattori o post-processori. È così che vengono supportati siti insoliti senza dover attendere una patch a monte. È anche così che si integrano i plugin del provider PoToken, di cui si parlerà più avanti.

La situazione di PoToken e SABR nel periodo 2025-2026

Nel 2025 YouTube ha reso la vita più difficile a yt-dlp. Due modifiche sono la ragione per cui un'installazione perfettamente funzionante potrebbe improvvisamente iniziare a dare problemi nel 2026.

PoToken è la novità più importante. Ogni richiesta video ora necessita di un Proof-of-Origin Token. Il token è associato al video, scade rapidamente ed è anche legato alla sessione. L'estrazione manuale ha smesso di funzionare mesi fa. Ciò che funziona è un piccolo helper chiamato `bgutil-ytdlp-pot-provider` che viene eseguito in background; genera i token su richiesta e la chiamata principale yt-dlp li recupera automaticamente. La wiki di yt-dlp ha una guida chiamata PO Token Guide che illustra la configurazione. Senza l'helper, le richieste vengono restituite con una qualità inferiore o semplicemente bloccate e yt-dlp potrebbe non funzionare correttamente anche con i video riprodotti nel browser trenta secondi prima.

SABR è il secondo elemento. SABR è il bitrate adattivo lato server di YouTube e, a partire dal 2025, l'estrattore `web` ha iniziato a restituire formati compatibili solo con SABR, interrompendo il normale percorso di download. La soluzione consiste solitamente nell'aggiungere un suggerimento agli argomenti dell'estrattore e utilizzare i cookie di un browser con accesso effettuato. I thread da seguire mentre la soluzione si evolve sono i problemi #12482, #14307, #14390, #16082 e #13968. Risultato finale: yt-dlp funziona ancora sulla stragrande maggioranza dei contenuti pubblici di YouTube, ma nel 2026 un comando che "funziona e basta" spesso richiede invece "un provider PoToken, cookie aggiornati e un po' di pazienza".

yt-dlp

Status legale di yt-dlp nel 2026: Stati Uniti, Germania, Unione Europea

La questione legale è di natura giurisdizionale, e il punto fondamentale è che nulla è stato ancora definitivamente risolto.

Negli Stati Uniti , nessun tribunale si è pronunciato specificamente su yt-dlp. Il caso RIAA del 2020 è il precedente più vicino e si è concluso con un'inversione di sentenza senza ricorso in tribunale. La nona norma triennale definitiva della Sezione 1201 dell'Ufficio del Copyright degli Stati Uniti è entrata in vigore il 28 ottobre 2024 e rimarrà valida fino al 28 ottobre 2027. Ha rinnovato le esenzioni precedenti e ne ha aggiunta una per la ricerca sull'affidabilità dell'IA, ma non ha creato un'esenzione generale per l'elusione del DRM per l'archiviazione di video personali. Il problema strutturale della Sezione 1201, ovvero la criminalizzazione degli strumenti che modificano il DRM a prescindere dall'intento, rimane.

In Germania , la controversia si è concentrata sulla responsabilità dei fornitori di hosting piuttosto che sul software in sé. Il 27 novembre 2024, la Corte d'Appello di Amburgo ha respinto l'appello di Uberspace, il fornitore di hosting di Magonza di `youtube-dl.org`. La decisione ha confermato una sentenza di primo grado del 2023, secondo cui i fornitori di hosting possono essere ritenuti responsabili per i siti che pubblicizzano strumenti per aggirare le protezioni. La dottrina non vieta direttamente yt-dlp, ma rende rischioso l'hosting in Germania per qualsiasi progetto che pubblicizzi in modo visibile funzionalità di elusione.

A livello UE , il Digital Services Act standardizza le procedure di rimozione con notifica e intervento (articoli 16-17), ma non regolamenta i software di download. Non esiste una normativa a livello europeo che obblighi i provider di hosting a bloccare yt-dlp. L'utilizzo personale di yt-dlp sui propri contenuti non rappresenta il punto di pressione legale in nessuna di queste giurisdizioni. Lo stesso vale per i contenuti per i quali il creatore ha dato il permesso. Le difficoltà risiedono nella distribuzione e nell'interazione con i sistemi di protezione dello streaming.

Interfacce grafiche e l'ecosistema più ampio dei programmi di download

Non tutti desiderano un terminale e la riga di comando di yt-dlp non è un punto di forza in termini di marketing. yt-dlp è uno dei tanti downloader video, ma funge da motore di funzionamento alla base della maggior parte delle moderne interfacce grafiche per il download di video. Stacher è l'interfaccia grafica multipiattaforma più curata. Tartube è un'alternativa basata su Python/GTK. yt-dlg è un fork della community specificamente progettato per yt-dlp. Tube-Archivist è un server Docker self-hosted per l'archiviazione di canali; può scaricare video da vari siti web a intervalli programmati. YTDL-Material è un frontend web self-hosted. ytdl-sub è uno strumento di configurazione YAML dichiarativo popolare tra gli utenti self-hosted di Plex e Jellyfin. JDownloader 2 integra yt-dlp tramite un plugin. Ogni strumento espone la propria interfaccia di selezione video e il pannello delle opzioni di download, ma il lavoro più impegnativo è svolto da yt-dlp.

Attrezzo Stato attuale (2026) Ambito di applicazione Licenza
yt-dlp Pubblicazioni attive e settimanali Oltre 1800 siti video/audio Senza licenza
youtube-dl Lento, ultima versione rilasciata a settembre 2021. YouTube + circa 1.000 siti Senza licenza
gallery-dl Attivo Gallerie di immagini; per i video è possibile contattare yt-dlp. GPLv2
collegamento streaming Attivo Streaming live trasmesso a un lettore BSD-2

La regola generale: yt-dlp per i download da archivio, streamlink per la riproduzione in diretta su un player, gallery-dl per i siti ricchi di immagini.

Sicurezza: dove scaricare yt-dlp e come riconoscere i falsi

Le uniche fonti sicure sono le release di GitHub, PyPI (`pip install yt-dlp`), i pacchetti di distribuzione ufficiali e i principali gestori di pacchetti di Windows (Winget, Scoop, Chocolatey). I siti di terze parti che offrono "downloader di yt-dlp" spesso includono adware, miner o binari modificati. Windows Defender ha storicamente segnalato il file `yt-dlp.exe` distribuito tramite PyInstaller come `Trojan:Win32/Wacatac.B!ml` (problemi n. 7532 e n. 15415). Si tratta di falsi positivi euristici. I database delle firme vengono solitamente svuotati entro pochi giorni. I piccoli progetti open source come yt-dlp sopravvivono grazie al lavoro di volontari. Le donazioni in criptovalute tramite gateway come Plisio rappresentano un modo, resistente ai controlli bancari, per i contributori internazionali di ricevere supporto.

Un esempio pratico. Supponiamo di voler scaricare un video di YouTube sul computer per una presentazione. Il comando è `yt-dlp -f "bv*+ba/b" --merge-output-format mp4 URL`, che fornisce il formato di download corretto. yt-dlp è un fork con più estrattori rispetto a youtube-dl e ne ha molti che consentono di scaricare un video anche quando l'originale non funziona. yt-dlp, grazie al suo sistema di plugin, supporta fonti di nicchia e consente di specificare `-a urls.txt` quando è necessario scaricare video da vari siti web. Tutto ciò che è supportato da yt-dlp è elencato in `supportedsites.md`.

Qualsiasi domanda?

Sì, da fonti ufficiali: GitHub Releases, PyPI, pacchetti delle distribuzioni. Windows Defender segnala il binario come falso positivo. I siti di terze parti che includono "yt-dlp" diffondono adware. Verifica che l`URL sia github.com/yt-dlp/yt-dlp.

Quasi sempre PoToken o SABR. YouTube ora associa un Proof-of-Origin Token a ogni richiesta e il suo protocollo di streaming SABR interrompe i flussi di download standard. Installa il plugin `bgutil-ytdlp-pot-provider`, passa `--cookies-from-browser firefox` e aggiorna yt-dlp all`ultima versione.

Sì. Il comando è `yt-dlp -x --audio-format mp3 URL`, dove `-x` estrae l`audio e `--audio-format` seleziona il contenitore. Sostituisci `mp3` con `m4a`, `opus` o `flac` per altri formati. Abbinato a `--embed-thumbnail --embed-metadata`, il file audio risultante viene visualizzato correttamente nei lettori musicali.

Il metodo più semplice è eseguire `winget install yt-dlp.yt-dlp` seguito da `winget install Gyan.FFmpeg`. Anche Scoop e Chocolatey funzionano. Per un`installazione nativa in Python, utilizzare `python -m pip install -U yt-dlp`. Aggiornare con `yt-dlp -U`. Il file eseguibile autonomo `yt-dlp.exe` è disponibile su GitHub Releases.

Stessa eredità, velocità molto diversa. yt-dlp rilascia circa venti o trenta versioni all`anno; l`ultima versione di youtube-dl risale al 2021. yt-dlp aggiunge SponsorBlock, selezione avanzata del formato come `-f "bv*+ba/b"`, frammenti HLS paralleli, cookie dal browser, registrazione in diretta, un flag per l`archivio di download e un estrattore di YouTube funzionante.

Giurisdizione. Nessun tribunale statunitense si è pronunciato specificamente su yt-dlp; in Germania, la sentenza di Amburgo del novembre 2024 rende i provider di hosting responsabili per i siti che segnalano metodi per aggirare il blocco. L`utilizzo di yt-dlp sui propri caricamenti o con il permesso del creatore non è legalmente contestato da nessuna parte. I contenuti protetti da copyright si trovano in una zona grigia.

Ready to Get Started?

Create an account and start accepting payments – no contracts or KYC required. Or, contact us to design a custom package for your business.

Make first step

Always know what you pay

Integrated per-transaction pricing with no hidden fees

Start your integration

Set up Plisio swiftly in just 10 minutes.