Cosa vuoi
Solo audio estrae la traccia sonora e scarta il video.
Riferimento delle opzioni yt-dlp
Scritto per yt-dlp 2026.07.21. Tra una versione e l'altra le opzioni vengono aggiunte e rinominate, quindi controlla la tua con yt-dlp --version.
Base
Video e qualità
-f FORMAT
--format
Qualità massima
Mette un tetto all'altezza. yt-dlp sceglie comunque la traccia migliore entro quel limite.
-f FORMAT
--format
format selector personalizzato
Sostituisce il menu della qualità. Per chi conosce già la sintassi dei formati.
Esempi
-f "bv*[vcodec^=av01]+ba"-f "b[filesize<50M]"
--merge-output-format FORMAT
richiede ffmpeg
Container
Il tipo di file in cui vengono uniti video e audio separati.
--remux-video FORMAT
richiede ffmpeg
Remux in
Reimpacchetta le tracce senza ricodificare. Veloce e senza perdite.
--recode-video FORMAT
richiede ffmpeg
Ricodifica in
Ricodifica il video. Lento e con perdite — solo se remux non basta.
Audio
--audio-format FORMAT
richiede ffmpeg
Formato audio
Il file in cui l'audio viene convertito.
--audio-quality QUALITY
richiede ffmpeg
Qualità audio
Il VBR dà il miglior rapporto dimensione/qualità; un bitrate fisso è più prevedibile.
Sottotitoli
Sottotitoli
Incorporare li mette dentro il video; salvare scrive un .srt separato accanto.
Lingue dei sottotitoli
Separate da virgola. Scrivi all per tutte le lingue disponibili.
Esempi
--sub-langs "en,vi"--sub-langs "en.*,ja"--sub-langs all
Sottotitoli automatici
Include i sottotitoli generati dalla macchina quando non ce ne sono scritti da persone.
Playlist e canali
Gestione delle playlist
Cosa fare quando l'URL appartiene sia a un video sia a una playlist.
-I ITEM_SPEC
--playlist-items
Quali elementi
Funzionano sia gli intervalli sia gli elenchi, per esempio 1-10,15 oppure -5::2 per uno ogni due partendo dalla fine.
Esempi
-I 1:5-I "1,3,7-10"-I "-5::2"
File di registro
Annota cosa è già stato scaricato, così una nuova esecuzione lo salta. È così che si tiene sincronizzato un canale.
Spezzoni e capitoli
--download-sections REGEX
richiede ffmpeg
Scarica solo uno spezzone
Un intervallo come *00:01:30-00:03:00, oppure il nome di un capitolo. L'asterisco iniziale indica che è un orario.
Esempi
--download-sections "*00:01:30-00:03:00"--download-sections "intro"
--split-chapters
richiede ffmpeg
Dividi per capitoli
Scrive un file per capitolo invece di uno lungo.
Metadati e copertina
--embed-thumbnail
richiede ffmpeg
Incorpora la miniatura
Usa la miniatura del video come copertina.
--embed-metadata
richiede ffmpeg
Incorpora i metadati
Scrive titolo, autore e data dentro il file stesso.
--embed-chapters
richiede ffmpeg
Incorpora i capitoli
Aggiunge i segnaposto dei capitoli, tra cui il player può saltare.
Salva il file della miniatura
Scrive l'immagine di copertina accanto al video.
Salva la descrizione
Scrive la descrizione in un file .description.
Salva i metadati in JSON
Scrive tutto ciò che yt-dlp sa del video in un file .info.json.
SponsorBlock
--sponsorblock-remove CATS
richiede ffmpeg
Rimuovi spezzoni
Taglia dal file gli spezzoni segnalati dalla comunità, in base ai dati di SponsorBlock.
Segna gli spezzoni come capitoli
Tiene gli spezzoni ma li segnala, così li salti tu.
File e cartelle
-o [TYPES:]TEMPLATE
--output
Modello del nome file
I nomi dei campi vanno dentro %(...)s. Le barre creano cartelle.
Esempi
-o "%(title)s.%(ext)s"-o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH
--paths
Cartella di download
Dove vengono scritti i file. Combinandola col modello sopra si ottengono sottocartelle.
Nomi file sicuri (solo ASCII)
Toglie accenti, spazi e qualsiasi carattere che un filesystem pignolo potrebbe rifiutare.
Nomi compatibili con Windows
Toglie i caratteri che Windows rifiuta, anche se stai lavorando su un altro sistema.
Accorcia i nomi a
Lunghezza massima del nome file, in caratteri.
Sovrascrivi i file esistenti
Sostituisce i file già presenti.
-w
--no-overwrites
Non sovrascrivere mai
Salta tutto ciò che è già stato scaricato.
-c
--continue
Riprendi i download interrotti
Riparte da dove il download si era fermato.
Filtri
Caricato dopo il
AAAAMMGG, oppure una data relativa come now-1month.
Esempi
--dateafter 20240101--dateafter now-1month
Caricato prima del
AAAAMMGG, oppure una data relativa.
Dimensione minima
Salta tutto ciò che è più piccolo. Accetta 5M, 500K e simili.
Dimensione massima
Salta tutto ciò che è più grande.
Fermati dopo
Quanti file scaricare prima di fermarsi.
Rete
-r RATE
--limit-rate
Limite di velocità
Per esempio 2M o 500K. Utile quando ti serve il resto della banda.
-N N
--concurrent-fragments
fragment in parallelo
Velocizza i flussi frammentati. Quattro è un punto di partenza sensato.
-R RETRIES
--retries
Tentativi
Quante volte riprovare una parte fallita. È ammesso anche infinite.
Proxy
URL di un proxy HTTP, HTTPS o SOCKS.
Aggira il blocco geografico
Finge l'origine della richiesta. Funziona su alcuni siti, non su tutti.
Spacciati per un browser
Fa sembrare le richieste provenienti da un browser vero. È il rimedio classico quando compare un 403 improvviso.
Accesso e cookies
Cookies dal browser
Legge direttamente la tua sessione. Serve per contenuti privati, con limite d'età o riservati agli iscritti.
File cookies
Un cookies.txt in formato Netscape esportato dal tuo browser.
Diretta
Registra dall'inizio
Avvia la registrazione della diretta dal principio invece che dal momento attuale.
Aspetta la diretta
Continua a controllare finché una diretta programmata non parte. MIN-MAX sono i secondi tra i controlli.
Aggiramenti
--user-agent UA
deprecato — --add-headers
User agent
Deprecato in favore di --add-headers. Resta perché tante guide vecchie lo usano ancora.
--referer URL
deprecato — --add-headers
Referer
Deprecato in favore di --add-headers.
Argomenti di extractor
Opzioni specifiche di un sito, per esempio youtube:player_client=web.
Esempi
--extractor-args "youtube:player_client=web,android"