Global Config

Global Config #

Global config is some CLI flags that can be set in every command.

Set Global Config EVERYTIME!

Global config does not mean that the configuration will be persisted or only need to be set once in global settings, they will only take effect in the current command. You need to set them in each command.

-n/--ns #

Each namespace represents a Telegram account. Default: default.

If you want to add another account, just add -n YOUR_ACCOUNT_NAME option to every command:

tdl -n iyear

--proxy #

Set the proxy. Default: "".

Format: protocol://username:password@host:port

tdl --proxy socks5://localhost:1080
tdl --proxy http://localhost:8080
tdl --proxy https://localhost:8081

--storage #

Set the storage. Default: type=bolt,path=~/.tdl/data

Format: type=DRIVER,opt1=val1,opt2=val2,...

Available drivers:

DriverOptionsDescription
bolt (Default)path=/path/to/data-directoryStore data in separate database files. So you can use it in multiple processes(must be different namespaces).
filepath=/path/to/data.jsonStore data in a single JSON file, which is useful for debugging.
legacypath=/path/to/data.kvDeprecated. Store data in a single database file. So you can’t use it in multiple processes.
--Wait for more drivers…
tdl --storage type=bolt,path=/path/to/data-dir

--ntp #

Set ntp server host. If it’s empty, system time will be used. Default: "".

tdl --ntp pool.ntp.org

--reconnect-timeout #

Set Telegram client reconnect timeout. Default: 2m.

Set higher timeout or 0(INF) if your network is poor.
tdl --reconnect-timeout 1m30s

--debug #

Enable debug level log. Default: false.

tdl --debug

--pool #

Set the DC pool size of Telegram client. Default: 8.

Set higher timeout or 0(INF) if you want faster speed.
tdl --pool 2

--delay #

set the delay between each task. Default: 0s.

Set higher delay time if you want to avoid Telegram’s flood control.
tdl --delay 5s