ZDL
Come si usa ZDL
Strumenti e funzioni
Espandere ZDL
English version Versione italiana

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.

--open-relink=link

Processa i collegamenti fino all’ultimo URL raggiungibile a partire da link, poi apre tale URL usando il browser web configurato

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

--external-application-button [HREF]

Per usare ZDL come gestore esterno di download per Firefox, Opera, Chrome/Chromium. L’opzione deve essere inserita nel campo Arguments delle preferenze dell’estensione External Application Button. [HREF] non deve essere modificato.

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:

  1. l’host del server IRC (HOST)
  2. il canale a cui connettersi (CHAN)
  3. 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://

-X keywords, --xdcc-search=keywords

Utilizzando il motore di ricerca di https://www.xdcc.eu avvia la ricerca di file disponibili per il download via XDCC. Il risultato della ricerca è aperto da una GUI, per permettere una selezione dei file da scaricare. Lo stesso tipo di ricerca può essere effettuato da --gui e --web-ui. keywords è la chiave di ricerca è deve essere racchiusa fra virgolette singole o doppie.

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):