Guida di installazione passo passo per Windows, macOS e Linux.
yt-dlp è un potente downloader multimediale da riga di comando (un fork attivamente mantenuto di youtube-dl) che ti permette di scaricare video e audio da migliaia di siti web. Poiché funziona nel terminale, non ha un'interfaccia grafica nativa.
Per scaricare video di alta qualità (1080p, 4K, ecc.) o estrarre audio MP3, devi installare FFmpeg. Inoltre, l'installazione di un runtime JavaScript come Deno è altamente consigliata per aggirare la limitazione di velocità di YouTube e i blocchi bot. Di seguito trovi la guida completa per configurare questi strumenti sul tuo dispositivo.
Non vuoi installare software? Puoi eseguire qualsiasi comando direttamente nella nostra console online senza alcuna configurazione.
Windows 10 (1809+) e Windows 11 includono il Gestione pacchetti Windows (winget) per impostazione predefinita. Gestisce installazione, percorsi e aggiornamenti automaticamente.
winget install yt-dlpPer utenti avanzati che utilizzano gestori di pacchetti da riga di comando su Windows.
scoop install yt-dlpchoco install yt-dlpScarica direttamente il binario eseguibile autonomo.
C:\yt-dlp\, e sposta il yt-dlp.exe scaricato al suo interno.
C:\yt-dlp, poi clicca OK in tutte le finestre di dialogo.Homebrew è il gestore di pacchetti standard per macOS. Risolve automaticamente tutte le dipendenze, inclusi Python e FFmpeg.
brew install yt-dlpIn alternativa, puoi installare yt-dlp usando il gestore di pacchetti MacPorts.
sudo port install yt-dlpScarica il binario compilato direttamente nel tuo percorso di esecuzione locale.
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpL'uso del gestore pip di Python assicura di ottenere direttamente gli ultimi aggiornamenti per gli script di estrazione video.
python3 -m pip install -U yt-dlpInstalla yt-dlp tramite il gestore di pacchetti della tua distribuzione Linux.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlpScarica il binario Linux autonomo direttamente nel tuo percorso di binari eseguibili locale.
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpFFmpeg è una libreria multimediale open source che yt-dlp usa internamente per unire download separati di tracce video ad alta definizione (1080p, 4K) e tracce audio, o per estrarre l'audio come MP3. Senza FFmpeg, yt-dlp scaricherà solo stream a 720p o qualità inferiore con audio integrato.
Usa winget per installare FFmpeg con un comando:
winget install Gyan.FFmpegIn alternativa, scarica le build da Gyan.dev, decomprimi e aggiungi la cartella bin alla tua variabile di ambiente PATH.
Se usi Homebrew, si installa automaticamente. Installa manualmente con:
brew install ffmpegInstalla tramite il gestore di pacchetti del sistema:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno è un runtime JavaScript moderno. yt-dlp usa Deno internamente per eseguire gli algoritmi di decrittazione delle firme basati su JavaScript di YouTube. Installare Deno aiuta ad aggirare la limitazione della velocità di download di YouTube e i blocchi di rilevamento bot "n-challenge".
Usa winget per installare Deno con un comando:
winget install DenoLand.DenoIn alternativa, usa Scoop: scoop install deno
Installa Deno tramite Homebrew:
brew install denoInstalla Deno usando lo script shell ufficiale:
curl -fsSL https://deno.land/install.sh | shAssicurati che unzip e curl siano installati prima di eseguire questo script.
Una volta installato, apri il terminale (PowerShell, Prompt dei comandi o Terminal.app) e verifica che tutto funzioni eseguendo il comando di verifica della versione.
Esegui il comando di interrogazione della versione nel tuo terminale:
yt-dlp --versionSe installato correttamente, stamperà un numero di versione con data di rilascio come:
2026.06.18Se ottieni "Comando non trovato", assicurati di riavviare il terminale o verifica che la cartella contenente yt-dlp sia correttamente aggiunta al PATH del tuo ambiente di sistema.
Hai problemi? Ecco le soluzioni per gli errori yt-dlp più comuni su Windows, macOS e Linux.
yt-dlp non è nel tuo PATH di sistema. Se hai installato tramite winget, Homebrew o pip, semplicemente chiudi e riapri il terminale — il PATH viene aggiornato solo per le nuove sessioni.
yt-dlp.exe manualmente, devi aggiungere la sua cartella alla variabile d'ambiente PATH. Vedi i passaggi dettagliati per la configurazione del PATH sopra.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp o brew upgrade yt-dlp).
yt-dlp -U), poiché i metodi di bypass della limitazione vengono aggiornati frequentemente.
yt-dlp.exe autonomo è costruito usando PyInstaller, che raggruppa un interprete Python in un singolo eseguibile. I software antivirus spesso segnalano i bundle PyInstaller perché la stessa tecnica di packaging è usata da alcuni malware — ma yt-dlp stesso è completamente sicuro.
winget install yt-dlp (i pacchetti verificati da Microsoft non vengono segnalati).
YouTube e altre piattaforme video aggiornano frequentemente i loro protocolli di streaming, il che può causare il malfunzionamento delle versioni precedenti di yt-dlp. Mantieni la tua installazione locale aggiornata per risolvere automaticamente gli errori di estrazione.
Se hai scaricato il binario direttamente o installato tramite pip, esegui il comando di aggiornamento integrato nel tuo terminale:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Inizia con questi comandi base nel tuo terminale:
| Obiettivo | Comando | Azioni |
|---|---|---|
| Scarica video (migliore qualità) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| Estrai audio MP3 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Sì, yt-dlp è sicuro. È un progetto 100% open source con licenza Unlicense, ospitato su GitHub con oltre 100.000 stelle e centinaia di contributori attivi. Ogni riga di codice è pubblicamente verificabile.
winget per evitare questo problema.Se preferisci non eseguire file localmente, la nostra console online esegue yt-dlp sui nostri server — nulla viene installato sul tuo dispositivo.
100K+ ⭐
Open Source su GitHub
Esegui i tuoi comandi yt-dlp direttamente sul nostro server. Usa la nostra interfaccia web per scaricare playlist, registrare stream ed estrarre audio istantaneamente.