TROVA I FILE SCARICATI PIÙ FACILMENTE

Modelli di nomi file gallery-dl: nomi, cartelle e metadati

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.

Nomi basati sui metadatiCartelle ordinateVerifica prima del download
Illustrazione editoriale di un terminale che organizza file basati sui metadati in cartelle ordinate
Un modello collega i campi dell'estrattore a una struttura di cartelle locale e ripetibile.
In breve: prima controlla, poi formatta

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.

PARTI DAL RISULTATO

Cosa controllano i modelli di nomi file di gallery-dl

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.

SCOPRI I CAMPI DISPONIBILI

Usa -K per controllare le chiavi sostituibili

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.

Diagramma editoriale che mostra i metadati controllati e combinati per formare un nome file
L'output di -K è l'elenco dei campi da usare per il modello di quello specifico estrattore.
Elenca i campi di un URL
gallery-dl -K "URL"
Simula l'estrazione senza scaricare
gallery-dl --simulate "URL"
CREA UN NOME LEGGIBILE

Crea un formato per i nomi file di gallery-dl

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.

Prova un nome file
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"
Configurazione specifica per l'estrattore
{
  "extractor": {
    "example": {
      "filename": "{id}_{title}.{extension}"
    }
  }
}
Esempio di formatoQuando è utileCosa verificare
{id}_{extension}I titoli mancano o cambiano spessoChe l'ID sia presente e univoco per l'estrattore
{date}_{id}_{title}Vuoi sfogliare i file in ordine cronologicoChe la data abbia un valore e un formato prevedibili
{author}/{title}Vuoi creare una cartella per ogni autoreChe i valori dell'autore siano sicuri come segmenti di percorso
{category}_{id}_{title}.{extension}Più siti condividono la stessa cartella principaleChe categoria ed estensione siano elencate da -K
SEPARA LE RACCOLTE

Usa modelli di directory per cartelle prevedibili

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.

Raggruppa per sito e autore
{
  "extractor": {
    "example": {
      "directory": ["{category}", "{author}"],
      "filename": "{id}_{title}.{extension}"
    }
  }
}
GESTISCI I DIVERSI TIPI DI FILE

Aggiungi con cautela formati condizionali

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.

Assegna nomi distinti ai video
{
  "extractor": {
    "example": {
      "filename": {
        "extension == 'mp4'": "{id}_video.{extension}",
        "": "{id}_{title}.{extension}"
      }
    }
  }
}
MANTIENI I NOMI PORTABILI

Controlla i limiti di Windows, Linux e macOS

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.

Illustrazione editoriale di un nome file che supera controlli di compatibilità prima di entrare in una cartella
La verifica multipiattaforma considera insieme i caratteri, la lunghezza, i separatori e la destinazione.
Caso di provaPerché contaCome ridurre il rischio
Punteggiatura riservataWindows non accetta alcuni caratteriAttiva una modalità di restrizione e controlla l'anteprima
Titolo lungoL'intero percorso può superare i limitiPreferisci {id} e un titolo abbreviato
Campo mancanteUna chiave ipotizzata può risultare vuota o non validaUsa -K e un formato di ripiego
Testo non latinoFile system e shell possono comportarsi in modo diversoUsa UTF-8 e prova sul computer di destinazione
VERIFICA IL RISULTATO

Un flusso di lavoro sicuro per i modelli di nomi file

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.

Confronto senza configurazione
gallery-dl --config-ignore --simulate "URL"
Controlla la configurazione attiva
gallery-dl --config-status
Primo download limitato
gallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"
CORREGGI IL LIVELLO PIÙ SEMPLICE

Risolvi nomi vuoti, duplicati o non validi

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.

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

Il percorso viene rifiutato

Accorcia il formato, rimuovi i caratteri riservati e prova sul computer di destinazione.

  • Controlla i caratteri
  • Controlla la lunghezza
  • Prova valori non latini
Esegui prove autorizzate e riproducibili

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 PROCESSO SEMPLICE

Una routine di denominazione ripetibile

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.

Domande frequenti

Domande frequenti sui modelli di nomi file di gallery-dl

Come vedo i campi supportati nei nomi file?

Esegui gallery-dl -K "URL". Il comando elenca chiavi per directory e nomi file con esempi dell'estrattore. Usa quell'elenco per il modello.

Qual è un formato semplice per i nomi file?

Prova {id}_{title}.{extension} se questi campi appaiono in -K. Aggiungi categoria o data solo dopo una verifica con pochi file.

Posso creare cartelle con i metadati?

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.

Perché il modello funziona su un sito ma non su un altro?

Le chiavi dipendono dall'estrattore. Esegui -K per ogni URL e conserva le impostazioni del sito nella sezione più specifica.

Come rendo sicuri i nomi su Windows?

Usa una modalità di restrizione per Windows e un formato breve. Prova punteggiatura, titoli lunghi, campi mancanti e percorso completo sul computer di destinazione.

Un modello evita i download duplicati?

No: controlla soltanto i nomi locali. Usa un file --download-archive stabile per ricordare i download precedenti e mantieni un ID nel nome.

Riferimenti ufficiali

Documentazione ufficiale di configurazione di gallery-dlOpzioni ufficiali della riga di comando di gallery-dlCodice sorgente e segnalazioni di gallery-dl
PASSO SUCCESSIVO

Risorse correlate