Il comando ZDL

ZDL è un programma per la Bash, scritto prevalentemente con il linguaggio della Bash. Di seguito, l'esposizione sintetica della sintassi, delle opzioni e degli altri argomenti del comando zdl. Per maggiori informazioni, consulta le sezioni specializzate. ZDL è predisposto per il completamento automatico degli argomenti (usare il tasto <Tab>).

Sintassi

zdl [OPZIONI] [file ...] [link ...] [directory]

Argomenti

L'ordine delle opzioni e degli altri argomenti non è importante:

file: Nomi dei file da cui estrarre i link. I file devono essere testuali oppure container DLC o file TORRENT, questi ultimi contrassegnati rispettivamente dalle estensioni .dlc e .torrent (ZDL processa comunque i link in memoria nella directory e quelli in input)
link: URL dei file oppure delle pagine web dei servizi di hosting, streaming o di reindirizzamento (se omessi, ZDL processa quelli in memoria nella directory e nei file). Per scaricare via IRC/XDCC, il link deve avere la seguente forma (porta non necessaria se è 6667): irc://[HOST[:PORT]]/[CHAN]/msg [PRIVMSG]. ZDL accetta anche i link di xWeasel, con protocollo xdcc://.
directory: Directory di avvio di ZDL e di destinazione dei download (se omessa, è quella corrente)

Opzioni

Le opzioni brevi non seguite da valori possono essere contratte: -ufmd equivale a -u -f -m -d

-h, --help

Help di ZigzagDownLoader (ZDL)

--list-extensions

Elenco delle estensioni di ZigzagDownLoader (ZDL)

--aria2

Scarica con Aria2

--axel

Scarica con Axel

--wget

Scarica con Wget

-m [numero], --max-downloads[=numero]

Download parallelo. È possibile indicare il numero massimo di download da effettuare contemporaneamente

--login

Utilizza eventuali account registrati per i servizi abilitati (configurare ZDL)

-u, --update

Aggiorna ZDL

-f, --force

Forza l'aggiornamento manuale di ZDL

--clean

Cancella eventuali file temporanei dalla directory di destinazione, prima di effettuare il download

-d, --daemon

Avvia ZDL in modalità demone (può essere controllato attraverso l'interfaccia interattiva)

-i, --interactive

Avvia l'interfaccia interattiva di ZDL per i download che hanno come destinazione la directory attuale. I download gestiti possono essere attivi o registrati nei file temporanei della directory

-l, --lite

Avvia ZDL in modalità in standard output lite (sono validi i comandi della modalità in standard output). Può essere configurata come modalità di avvio predefinita.

--out=programma|file

Restituisce in output i nomi dei file dei download completati, in due modi alternativi:

programma: programma che può "aprire" il file scaricato
file: file testuale in cui sono registrati i nomi dei file

--live

Permette di selezionare canali per il download della diretta di alcune televisioni in "live stream”

--mp3

--flac

Convertono i file (anche da video in audio) in MP3 oppure in FLAC: dipendono da FFMpeg/AVConv

--ip

Scrive l'indirizzo IP attuale, prima di effettuare altre operazioni

--reconnect

Forza la riconnessione del modem al termine di ogni download, utilizzando uno script/comando/programma (configurare ZDL)

-r, --resume

Recupera o riscarica file parzialmente scaricati. Agisce in caso di omonimia fra file (leggi il manuale). Può essere configurato come comportamento predefinito

--no-complete

Cancella i file temporanei dei download completati

--no-stop

Avvio senza interruzioni: salta l'eventuale aggiornamento automatico (che richiede l'immissione della password) o la richiesta di immettere nuovi link. L'input da tastiera è comunque disponibile

Interfaccia grafica (GUI):

-g, --gui: Avvia l'interfaccia grafica nella directory corrente o in quella eventualmente inserita fra gli argomenti, attivando automaticamente zdl –daemon come "core", se ancora non è stato attivato zdl
--path-gui: Prima di avviare zdl, apre una finestra per la selezione della directory di destinazione, se non è indicata fra gli argomenti del comando (utile se "zdl –gui" è avviato da un'icona del desktop o da un'estensione del browser web, come "External Application Button")

Socket e interfacce utente:

-s [porta], --socket[=porta]: Avvia il programma collegandolo a un socket. Se non indicata, la porta è quella predefinita.
--web-ui: Interfaccia utente web. Avvia il programma in modalità demone nella directory corrente o, eventualmente, in quella passata come argomento, un socket alla porta predefinita o, se occupata da un'altra applicazione, alla prima porta libera e il browser predefinito all'indirizzo dell'interfaccia utente.

IRC/XDCC:

-x, --xdcc

Avvia l'inserimento interattivo di tre dati:

l'host del server IRC (HOST)
il canale a cui connettersi (CHAN)
il messaggio privato (PRIVMSG) che contiene il comando XDCC SEND

Il download via IRC/XDCC può essere affettuato, alternativamente e senza usare opzioni, inserendo le informazioni nel link, che deve avere la forma seguente (porta non necessaria se è 6667): irc://[HOST[:PORT]]/[CHAN]/msg [PRIVMSG]. ZDL accetta anche i link di xWeasel, con protocollo xdcc://

Torrent:

-T file, --torrent-file=file: File torrent per Aria2: può non avere estensione .torrent
--tcp-port=porta
--udp-port=porta: Porte TCP e UDP aperte: verificare le impostazioni del router

Filtri:

--scrape-url=URL pagina web: Estrae gli URL (i link) dalla pagina web indicata e li accoda all'elenco registrato
--scrape-url: Estrae gli URL (i link) dalle pagina web indicate come link
--url=regex: Processa solo gli URL (i link) che corrispondono alla REGEX
--no-url=regex: Non processa gli URL (i link) che corrispondono alla REGEX
--file=regex: Scarica solo file il cui nome corrisponde alla REGEX
--no-file=regex: Non scarica i file il cui nome corrisponde alla REGEX
--no-rev: Non scarica i file con estensione '.rev'
--no-sub: Non scarica i file il cui nome contiene la stringa 'sub' (in lettere maiuscole e minuscole), scarta i file video sottotitolati.

Avvio con un editor:

-e, --editor: sostituisce l'interfaccia di ingresso di ZDL con l'editor predefinito dal sistema oppure con quello configurato per ZDL con zdl -c
--emacs, --emacs-nw: usa Emacs o la sua versione solo testo/non grafica
--jed: usa Jed, un piccolo editor in stile Emacs
--jupp: usa Jupp
--mcedit: usa l'editor di Midnight Commander
--mg: usa Mg, un micro editor in stile Emacs
--nano: usa l'editor Nano
--vi, --vim: usa l'editor Vi o Vim
--zile: usa Zile, un micro editor GNU in stile Emacs

Avvio con Proxy:

--proxy

Avvia ZDL attivando un proxy automaticamente (il tipo di proxy predefinito è Transparent)

--proxy=t|a|e

Avvia ZDL attivando un proxy del tipo definito dall'utente:

t = Transparent
a = Anonymous
e = Elite

--proxy=IP:PORTA

Avvia ZDL attivando il proxy indicato dall'utente, per l'intera durata del download (il proxy viene sostituito automaticamente solo per i link dei servizi abilitati che necessitano di un nuovo indirizzo IP)

Configurazione:

-c, --configure: Interfaccia di configurazione di ZDL, permette anche di salvare eventuali account dei servizi di hosting
--stream [parametri] [--noXterm]: Per scaricare lo stream incorporando ZDL in nuovi script, il modello generico dei parametri per le componenti aggiuntive (rispettare l'ordine):