Il modello lascia campi vuoti
Esegui -K per l'URL, sostituisci i campi ipotizzati e usa un valore di ripiego.
- Verifica l'estrattore
- Controlla la configurazione
- Prova un campo alla volta
I modelli di nomi file di gallery-dl trasformano i metadati dell'estrattore in nomi e percorsi ordinati. Scopri come controllare i campi di un URL, comporre un formato semplice, gestire i limiti dei sistemi operativi e verificare il risultato prima di un download esteso.
Esegui gallery-dl -K "URL" per vedere le chiavi dell'estrattore. Usale in --filename o extractor.filename e imposta extractor.directory per le cartelle. Prova con --simulate prima di salvare la configurazione: le chiavi disponibili possono cambiare tra estrattori.
I modelli di nomi file gallery-dl sono stringhe valutate mentre si prepara un download. Combinano metadati come ID, titolo, data, autore, numero di pagina o estensione con separatori leggibili. Puoi comporre anche i segmenti delle directory e raggruppare i file per sito, autore o serie.
Il modello organizza i file locali, ma non modifica l'URL né la scelta dell'estrattore. Inizia con un formato breve, univoco e compatibile con i dispositivi usati.
La guida ufficiale consiglia -K, o --list-keywords, per un URL specifico. Il comando mostra le chiavi per directory e nomi file con valori di esempio. Usale come riferimento, senza copiare campi ipotizzati da tutorial per altri siti.
Usa un URL autorizzato e mantieni il controllo circoscritto. Gestisci l'accesso con il normale flusso del sito e cookie locali del browser; non inserire cookie o token nel modello o nei registri condivisi.
gallery-dl -K "URL"gallery-dl --simulate "URL"Parti da un identificatore stabile e aggiungi i campi utili. {category}_{id}_{title}.{extension} è facile da leggere; anteporre la data aiuta a ordinare i file. Controlla con -K che ogni campo esista per quell'estrattore.
Usa --filename per la prova. Dopo la simulazione e un breve download, sposta il formato nella sezione JSON dell'estrattore: le regole specifiche possono prevalere su quelle generali.
Scegli separatori semplici e lascia l'estensione alla fine. Mantieni un ID di ripiego per i contenuti senza titolo.
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"{
"extractor": {
"example": {
"filename": "{id}_{title}.{extension}"
}
}
}| Esempio di formato | Quando è utile | Cosa verificare |
|---|---|---|
| {id}_{extension} | I titoli mancano o cambiano spesso | Che l'ID sia presente e univoco per l'estrattore |
| {date}_{id}_{title} | Vuoi sfogliare i file in ordine cronologico | Che la data abbia un valore e un formato prevedibili |
| {author}/{title} | Vuoi creare una cartella per ogni autore | Che i valori dell'autore siano sicuri come segmenti di percorso |
| {category}_{id}_{title}.{extension} | Più siti condividono la stessa cartella principale | Che categoria ed estensione siano elencate da -K |
extractor.directory accetta un elenco di stringhe di formato: ciascuna diventa un segmento sotto la directory di base. Puoi separare sito, autore e raccolta senza costruire un nome file lungo.
Crea cartelle solo se servono. Prova autore e titolo con separatori, caratteri riservati e valori lunghi. Non inserire segreti o nomi di account privati in percorsi condivisi.
{
"extractor": {
"example": {
"directory": ["{category}", "{author}"],
"filename": "{id}_{title}.{extension}"
}
}
}La configurazione può associare condizioni ai formati. Vengono valutate nell'ordine indicato e vale la prima vera; una stringa vuota o il valore predefinito dell'estrattore offre un ripiego. È utile per raccolte con video e immagini.
Aggiungi una condizione alla volta e prova URL che la soddisfano e URL che non la soddisfano. Mantieni chiaro il ripiego e usa solo campi mostrati da -K.
{
"extractor": {
"example": {
"filename": {
"extension == 'mp4'": "{id}_video.{extension}",
"": "{id}_{title}.{extension}"
}
}
}
}Un modello valido può generare un percorso non valido: i titoli possono contenere caratteri riservati o essere troppo lunghi. gallery-dl offre restrizioni per Windows, Unix e ASCII, oltre a una modalità personalizzata. Scegli quella adatta al computer e controlla l'anteprima.
Per configurazioni condivise, usa separatori prudenti e cartelle poco profonde. Prova punteggiatura, titoli mancanti, caratteri non latini e valori lunghi: conta l'intero percorso.
| Caso di prova | Perché conta | Come ridurre il rischio |
|---|---|---|
| Punteggiatura riservata | Windows non accetta alcuni caratteri | Attiva una modalità di restrizione e controlla l'anteprima |
| Titolo lungo | L'intero percorso può superare i limiti | Preferisci {id} e un titolo abbreviato |
| Campo mancante | Una chiave ipotizzata può risultare vuota o non valida | Usa -K e un formato di ripiego |
| Testo non latino | File system e shell possono comportarsi in modo diverso | Usa UTF-8 e prova sul computer di destinazione |
Scegli un URL supportato ed esegui -K. Simula un formato breve, poi scarica pochi elementi in una destinazione temporanea e controlla nomi e cartelle.
Ripeti con un altro URL, possibilmente con punteggiatura o titolo mancante. Quando funziona, salva l'impostazione e annota il comando verificato.
Se il comportamento cambia, controlla --config-status e confronta con --config-ignore --simulate. Conserva una configurazione funzionante e modifica una regola alla volta.
gallery-dl --config-ignore --simulate "URL"gallery-dl --config-statusgallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"Nomi generici possono indicare un campo mancante, una regola più specifica o una configurazione inattesa. Confronta -K con il modello, controlla --config-status e simula senza configurazione prima di aggiungere chiavi.
File ignorati o sovrascritti riguardano la selezione. I modelli non sostituiscono --download-archive né confrontano i file. Mantieni un identificatore e controlla URL, intervallo e filtri prima di cambiare la cronologia.
Esegui -K per l'URL, sostituisci i campi ipotizzati e usa un valore di ripiego.
Accorcia il formato, rimuovi i caratteri riservati e prova sul computer di destinazione.
I modelli organizzano i download locali. Non aggirano accessi, paywall, limiti di frequenza, controlli di sicurezza o regole delle piattaforme. Prova soltanto URL e contenuti a cui hai diritto di accedere e tieni le credenziali fuori dai comandi e dai registri.
Mantieni il modello breve e specifico per l'estrattore: scopri i campi con -K, simula, prova i casi limite e salva l'impostazione al livello più mirato. Documenta formato, destinazione e comando verificato.
Esegui gallery-dl -K "URL". Il comando elenca chiavi per directory e nomi file con esempi dell'estrattore. Usa quell'elenco per il modello.
Prova {id}_{title}.{extension} se questi campi appaiono in -K. Aggiungi categoria o data solo dopo una verifica con pochi file.
Sì. extractor.directory accetta stringhe di formato, ciascuna usata come segmento sotto il percorso di base. Prova autore e titolo perché possono contenere separatori o caratteri riservati.
Le chiavi dipendono dall'estrattore. Esegui -K per ogni URL e conserva le impostazioni del sito nella sezione più specifica.
Usa una modalità di restrizione per Windows e un formato breve. Prova punteggiatura, titoli lunghi, campi mancanti e percorso completo sul computer di destinazione.
No: controlla soltanto i nomi locali. Usa un file --download-archive stabile per ricordare i download precedenti e mantieni un ID nel nome.