Scaricare i sottotitoli YouTube — generatore di comandi yt-dlp

Componi un comando yt-dlp che salva i sottotitoli in .srt senza scaricare il video.

URL del video, della playlist o del canale

Facoltativo. Se lo lasci vuoto il comando finisce con URL, da riempire tu.

Il tuo comando

yt-dlp --write-subs --convert-subs srt --sub-langs en --write-auto-subs --no-playlist -s 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

Base

Cosa vuoi

Video Solo audio

Solo audio estrae la traccia sonora e scarta il video.

Video e qualità

Qualità massima -f

Mette un tetto all'altezza. yt-dlp sceglie comunque la traccia migliore entro quel limite.

Container --merge-output-format richiede ffmpeg

Il tipo di file in cui vengono uniti video e audio separati.

Opzioni avanzate (3)

format selector personalizzato -f

Sostituisce il menu della qualità. Per chi conosce già la sintassi dei formati.

Remux in --remux-video richiede ffmpeg

Reimpacchetta le tracce senza ricodificare. Veloce e senza perdite.

Ricodifica in --recode-video richiede ffmpeg

Ricodifica il video. Lento e con perdite — solo se remux non basta.

Audio

Formato audio --audio-format richiede ffmpeg

Il file in cui l'audio viene convertito.

Qualità audio --audio-quality richiede ffmpeg

Il VBR dà il miglior rapporto dimensione/qualità; un bitrate fisso è più prevedibile.

Sottotitoli

Incorporare li mette dentro il video; salvare scrive un .srt separato accanto.

Lingue dei sottotitoli --sub-langs

Separate da virgola. Scrivi all per tutte le lingue disponibili.

Sottotitoli automatici --write-auto-subs 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.

Quali elementi -I

Funzionano sia gli intervalli sia gli elenchi, per esempio 1-10,15 oppure -5::2 per uno ogni due partendo dalla fine.

Opzioni avanzate (1)

File di registro --download-archive

Annota cosa è già stato scaricato, così una nuova esecuzione lo salta. È così che si tiene sincronizzato un canale.

Spezzoni e capitoli

Opzioni avanzate (2)

Scarica solo uno spezzone --download-sections richiede ffmpeg

Un intervallo come *00:01:30-00:03:00, oppure il nome di un capitolo. L'asterisco iniziale indica che è un orario.

Dividi per capitoli --split-chapters richiede ffmpeg Scrive un file per capitolo invece di uno lungo.

Metadati e copertina

Incorpora la miniatura --embed-thumbnail richiede ffmpeg Usa la miniatura del video come copertina.

Incorpora i metadati --embed-metadata richiede ffmpeg Scrive titolo, autore e data dentro il file stesso.

Incorpora i capitoli --embed-chapters richiede ffmpeg Aggiunge i segnaposto dei capitoli, tra cui il player può saltare.

Opzioni avanzate (3)

Salva il file della miniatura --write-thumbnail Scrive l'immagine di copertina accanto al video.

Salva la descrizione --write-description Scrive la descrizione in un file .description.

Salva i metadati in JSON --write-info-json Scrive tutto ciò che yt-dlp sa del video in un file .info.json.

SponsorBlock

Rimuovi spezzoni --sponsorblock-remove richiede ffmpeg

Taglia dal file gli spezzoni segnalati dalla comunità, in base ai dati di SponsorBlock.

Opzioni avanzate (1)

Segna gli spezzoni come capitoli --sponsorblock-mark

Tiene gli spezzoni ma li segnala, così li salti tu.

File e cartelle

Modello del nome file -o

I nomi dei campi vanno dentro %(...)s. Le barre creano cartelle.

Nomi file sicuri (solo ASCII) --restrict-filenames Toglie accenti, spazi e qualsiasi carattere che un filesystem pignolo potrebbe rifiutare.

Sovrascrivi i file esistenti --force-overwrites Sostituisce i file già presenti.

Riprendi i download interrotti -c Riparte da dove il download si era fermato.

Opzioni avanzate (4)

Cartella di download -P

Dove vengono scritti i file. Combinandola col modello sopra si ottengono sottocartelle.

Nomi compatibili con Windows --windows-filenames Toglie i caratteri che Windows rifiuta, anche se stai lavorando su un altro sistema.

Accorcia i nomi a --trim-filenames

Lunghezza massima del nome file, in caratteri.

Non sovrascrivere mai -w Salta tutto ciò che è già stato scaricato.

Filtri

Opzioni avanzate (5)

Caricato dopo il --dateafter

AAAAMMGG, oppure una data relativa come now-1month.

Caricato prima del --datebefore

AAAAMMGG, oppure una data relativa.

Dimensione minima --min-filesize

Salta tutto ciò che è più piccolo. Accetta 5M, 500K e simili.

Dimensione massima --max-filesize

Salta tutto ciò che è più grande.

Fermati dopo --max-downloads

Quanti file scaricare prima di fermarsi.

Rete

Limite di velocità -r

Per esempio 2M o 500K. Utile quando ti serve il resto della banda.

Opzioni avanzate (5)

fragment in parallelo -N

Velocizza i flussi frammentati. Quattro è un punto di partenza sensato.

Tentativi -R

Quante volte riprovare una parte fallita. È ammesso anche infinite.

Proxy --proxy

URL di un proxy HTTP, HTTPS o SOCKS.

Aggira il blocco geografico --geo-bypass Finge l'origine della richiesta. Funziona su alcuni siti, non su tutti.

Spacciati per un browser --impersonate

Fa sembrare le richieste provenienti da un browser vero. È il rimedio classico quando compare un 403 improvviso.

Accesso e cookies

Cookies dal browser --cookies-from-browser

Legge direttamente la tua sessione. Serve per contenuti privati, con limite d'età o riservati agli iscritti.

Opzioni avanzate (1)

File cookies --cookies

Un cookies.txt in formato Netscape esportato dal tuo browser.

Diretta

Opzioni avanzate (2)

Registra dall'inizio --live-from-start Avvia la registrazione della diretta dal principio invece che dal momento attuale.

Aspetta la diretta --wait-for-video

Continua a controllare finché una diretta programmata non parte. MIN-MAX sono i secondi tra i controlli.

Aggiramenti

Opzioni avanzate (3)

User agent --user-agent deprecato

Deprecato in favore di --add-headers. Resta perché tante guide vecchie lo usano ancora.

Referer --referer deprecato

Deprecato in favore di --add-headers.

Argomenti di extractor --extractor-args

Opzioni specifiche di un sito, per esempio youtube:player_client=web.

Output e debug

Elenca solo i formati -F Stampa i formati disponibili e termina senza scaricare.

Opzioni avanzate (2)

Continua anche con gli errori -i Salta gli elementi che falliscono invece di fermarsi. Su playlist grandi è indispensabile.

Simula -s Fa tutto tranne scrivere il file.

Reimposta

Le opzioni che contano qui

Sottotitoli Incorporare li mette dentro il video; salvare scrive un .srt separato accanto.
Lingue dei sottotitoli --sub-langs Separate da virgola. Scrivi all per tutte le lingue disponibili.
Sottotitoli automatici --write-auto-subs Include i sottotitoli generati dalla macchina quando non ce ne sono scritti da persone.
Simula -s Fa tutto tranne scrivere il file.

I sottotitoli senza il video

La modalità simulazione fa tutto tranne scrivere il file video, quindi i sottotitoli li tieni e il download lo risparmi. La conversione in SRT richiede ffmpeg.

Se non compare nulla, molto probabilmente il video non ha sottotitoli scritti da persone: quelli automatici sono un'opzione a parte, e senza attivarla yt-dlp non trova niente e non lo dice nemmeno.

La modalità simulazione è l'interruttore portante di questa pagina: senza, yt-dlp scarica tutto il video e si limita a salvare anche i sottotitoli, cosa che su un file lungo quanto un film è tanta trasmissione per una traccia di testo. Con, l'esecuzione prende i metadati, scrive i file dei sottotitoli e non tocca mai il video. Il costo è che la modalità simulazione salta anche la scrittura di thumbnail e descrizione a cui eri forse abituato — quelle sono artefatti di una esecuzione video, non di sottotitoli.

La scelta della lingua è dove i download di sottotitoli diventano intricati. --sub-langs en prende esattamente la traccia etichettata "en"; en-orig è il nome di YouTube per quella generata automaticamente, e en.* come modello becca entrambe più le varianti regionali. Più lingue prendono un elenco separato da virgole. Se un video ha sia traccia umana sia automatica per la stessa lingua, sono due voci separate, e scaricarle entrambe è un esito legittimo, non un bug.

I formati contano quando il file dei sottotitoli va in un editor: SRT è l'interscambio sicuro, VTT porta lo stile che il player web mostra, e i formati JSON3/_SRV di YouTube sono pensati per macchine. L'interruttore converti-in-SRT gestisce il caso comune, richiede ffmpeg e perde lo stile di proposito — gli editor vogliono testo, non markup. Se l'output sembra vuoto, controlla che il file esista prima di dare per fallita la conversione: un SRT di zero byte significa che la traccia stessa era vuota.

I sottotitoli generati automaticamente meritano un avviso: sono trascrizione di macchina, con tutto ciò che implica — omofoni sbagliati, niente punteggiatura, nomi maltrattati. Per un video in una lingua che leggi sono un indice di ricerca; per tutto ciò che citerai, la traccia umana (quando esiste) è quella che vale la pena tenere. Le dirette prendono i sottotitoli automatici in diretta, salvati solo dopo la fine della trasmissione — le opzioni di registrazione live di questo sito sono per l'immagine, e i sottotitoli di una diretta finita si scaricano con le normali opzioni dei sottotitoli.

Domande frequenti

› Come scarico i sottotitoli senza il video?

Scegli l'opzione .srt e attiva la simulazione: salta la scrittura del file video ma salva comunque i sottotitoli.

› Perché non è comparso nessun file di sottotitoli?

Probabilmente il video non ha sottotitoli scritti da persone. Attiva quelli automatici per ottenere quelli generati dalla macchina.

› Come scelgo le lingue dei sottotitoli?

Separale con virgole, per esempio en,it. all per tutte quelle disponibili, oppure uno schema come en.* per tutte le varianti dell'inglese.

› Posso avere SRT invece di VTT?

Sì — l'opzione .srt li converte, e per questo serve ffmpeg.