decode-config 14.3.0.0

Backup/restore and decode configuration tool for Tasmota

decode-config

Convert, backup and restore configuration data of devices flashed with Tasmota firmware.

If you like decode-config give it a star or fork it and contribute:

In comparison with the Tasmota build-in "Backup Configuration" / "Restore Configuration" function the decode-config tool:

• uses a human readable and editable JSON-format for backup/restore
• can restore previously backed up and modified JSON-format files
• is able to process any subsets of configuration data
• can convert data from older Tasmota versions (starting with early v5.10.0) to a newer and current one and vice versa
• is able to create Tasmota command list for the most available configuration data related commands

Comparing backup files created by decode-config and .dmp files created by Tasmota "Backup Configuration" / "Restore Configuration":

Configuration	decode-config JSON file	Tasmota *.dmp file
encrypted	No	Yes
readable	Yes	No
editable	Yes	No
batch processing	Yes	No
Backup/Restore subsets	Yes	No

decode-config is compatible with all Tasmota versions, starting from Tasmota v5.10.0 up to the current one.

Development

Using the latest development version of decode-config is only necessary if you also use the latest development version of Tasmota.

Table of contents

Contents

• Development
• Table of contents
• Running the program
  • Installation
• Usage
  • Basics
  • Tasmota source
  • Format JSON output
  • Parameter file
  • Save backup
  • Restore backup
  • Auto file extensions
  • Test your parameter
  • Console outputs
  • Filter by groups
• Usage examples
  • Using Tasmota binary configuration files
  • Using JSON editable file
  • Use batch processing
• File Formats
  • .dmp format
  • .json format
  • .bin format
• Program parameter
  • --full-help
  • Parameter notes
  • Obsolete parameters
• Generated Tasmota commands
• Program return codes

Running the program

To use decode-config.py you can install it using Python environment and following the Installation section below.

Alternatively you can download a ready-made binary from Releases to use it without installing Python.

Installation

decode-config.py needs an installed Python environment - (see Prerequisite).

After you have installed your Python environment, there are two ways to install deocde-config:

Installation using PyPi

pip install decode-config

The program does not have a graphical user interface (GUI), you have to run it from your OS command line using program arguments - see Usage for more details.

Manual installation

This is only necessary if you want to run decode-config.py from development branch. First install the required modules manually

python -m pip install -r requirements.txt

After that you can use the Phython script decode-config.py as normal program:

decode-config.py

Prerequisite

Since decode-config.py is a Python program, it requires an installed Python environment.

Linux

Install Python 3.x and Pip:

sudo apt-get install python3 python3-pip

Windows

Install Python 3.x for Windows as described

MacOS

Install Python 3.x for macOS as described

Usage

For an overview start the program without any parameter and you will get a short help:

decode-config.py

This prints a short help:

usage: decode-config.py [-s <filename|host|url>] [-p <password>]
                        [--fulltopic <topic>] [--cafile <file>]
                        [--certfile <file>] [--keyfile <file>] [--insecure]
                        [--keepalive <sec>] [-i <restorefile>]
                        [-o <backupfile>] [-t json|bin|dmp] [-E] [-e] [-F]
                        [--json-indent <indent>] [--json-compact]
                        [--json-show-pw] [--cmnd-indent <indent>]
                        [--cmnd-groups] [--cmnd-sort]
                        [--cmnd-use-rule-concat] [--cmnd-use-backlog]
                        [-c <configfile>] [-S] [-T json|cmnd|command]
                        [-g <groupname> [<groupname> ...]] [-w] [--dry-run]
                        [-h] [-H] [-v] [-V]

For advanced help run decode-config with parameter --full--help or -H. This will print a Program parameter.

Note
If you're missing older parameters, don't worry, they're still there (see Obsolete parameters).

Basics

To get a program result, pass at least a Tasmota source from which you want to read the configuration data.

Tasmota source

The Tasmota source determines where the configuration data should be loaded from and saved to. A source can be an offline file or an online Tasmota device accessed via HTTP or indirectly via MQTT.

Use --source parameter to determine the configuration data source:

Binary (*.dmp) file (Offline)

Source is a Tasmota configuration file (having extension .dmp).

Pass the filename direclty or encoded as a file-URL:

decode-config --source tasmota-4281.dmp
decode-config -s file://path/to/tasmota-4281.dmp

HTTP connection (Online)

Source is an online HTTP connection to a running Tasmota device. To use this source, decode-config must have access to the network on which Tasmota is running, Tasmota Webserver running in admin mode (WebServer 2) is mandatory.

Specify the hostname, IP o or http-url of the Tasmota device.

An optionally required HTTP password, username and different HTTP port of the device can be specified via URL or separately via --username, --password and --port

decode-config --source tasmota-4281
decode-config -s 192.168.10.92
decode-config --source http://tasmota-4281 --password myPaszxwo!z
decode-config --source http://admin:myPaszxwo!z@tasmota-4281:8000
decode-config --source http://admin:myPaszxwo!z@tasmota-4281/cs?

An appended HTTP path (here "/cs?") is ignored.

MQTT transission (Online)

Source is a MQTT server and topic where an online Tasmota device is connected to. To use this source, decode-config does not need to have access to the same network that Tasmota is running on, it just needs access to the MQTT server that Tasmota also uses.

MQTT connection parameter

Specify the hostname or IP of the MQTT server (possibly also specify username and password for the MQTT server) and the Tasmota MQTT topic. The decode-config connection to MQTT server also allows SSL/TLS connection.

The MQTT username and password must be encoded within the URL (the parameter --password can not be used for that, it has a different function here).
If the username/password combination for the decode-config MQTT connection is different from the one used by Tasmota itself (Tasmota command MQTTPassword), the Tasmota MQTT password must be specified via the --password parameter.

The Tasmota topic can be specfied either within the URL path component or using optional --fulltopic parameter.
The topic must be the full topic of the Tasmota device without any trailing command or result part. You can use any of the prefixed topic (cmnd, stat or tele topic) or use the placeholder %prefix% for it, example
%prefix%/tasmota-4281 or tele/tasmota-4281 are valid topics
cmnd/tasmota-4281/POWER or tele/tasmota-4281/STATE are invalid topics due to the trailing part.

For SSL/TLS connection to MQTT server use mqtts:// URL scheme.

decode-config --source mqtts://mybroker.example.com/%prefx%/tasmota-4281
decode-config --source mqtts://mybroker.example.com:8883/tele/tasmota-4281
decode-config --source mqtts://mqttuser:myBrokerPaszxwo![e-mail]  --fulltopic tele/tasmota-4281
decode-config --source mqtts://mqttuser:myBrokerPaszxwo![e-mail]/tele/tasmota-4281 --password myTasmotaMQTTPaszxwo!z

For own certifications use the parameters --cafile, --certfile and --keyfile. To suppress certification verification use --insecure.

For none SSL/TLS connection to MQTT server use mqtt:// URL scheme.

decode-config --source mqtt://mybroker.example.com/%prefx%/tasmota-4281
decode-config --source mqtt://mybroker.example.com:1883/tele/tasmota-4281
decode-config --source mqtt://mqttuser:myBrokerPaszxwo![e-mail]  --fulltopic tele/tasmota-4281
decode-config --source mqtt://mqttuser:myBrokerPaszxwo![e-mail]/tele/tasmota-4281 --password myTasmotaMQTTPaszxwo!z

Format JSON output

All basic examples above will output a readable configuration in JSON-format, e.g.:

{"altitude": 112, "baudrate": 115200, "blinkcount": 10, "blinktime": 10,...
"ws_width": [1, 3, 5]}

Note
The json names (like "altitude" or "blinktime" are internal names from Tasmotas settings.h STRUCT Settings and are not the same as known from Tasmota web-console commands. However, since most variable names are self-describing, the functional meaning should be given in most cases.

The default JSON output can be formatted for better reading using the --json-indent <n> parameter:

decode-config --source tasmota-4281 --password "myPaszxwo!z" --json-indent 2

This will print a pretty better readable format and the example above becomes:

{
  "altitude": 112,
  "baudrate": 115200,
  "blinkcount": 10,
  "blinktime": 10,
  ...
  "ws_width": [
    1,
    3,
    5
  ]
}

Parameter file

Because the number of parameters are growing, it would be difficult to enter all these parameters again and again. In that case it is best to use a configuration file that contains your standard parameters and which we then have to specify as the only additional parameter.
Program parameter starting with -- (eg. --username) can be set into such a configuration file. Simply write each neccessary parameter including possible value without dashes into a text file. For a better identification of this file, extension .conf is recommended:

Writing all the previous used device parameter in a file, create the text file my.conf and insert:

[source]
username = admin
password = myPaszxwo!z

[JSON]
json-indent 2

Hint
Group names enclosed in square brackets [ ], like [source] in the example, are optional and ignored - you can use them to increase readability.

Now we can use it with -c parameter:

decode-config -c my.conf -s tasmota-4281

Note
For further of parameter file syntax see https://pypi.org/project/ConfigArgParse).

If parameters are specified in more than one place (parameter file and command line), the commandline parameters will overrule the file parameters. This is usefull if you use a basic set of parameters and want to change parameter once without the need to edit your configuration file:

decode-config -c my.conf -s tasmota-4281 --json-indent 4

Here JSON will be output with indent of 4 spaces instead of the 2 set from my.conf-

Save backup

To save data from a device or *.dmp file into a backup file, use --backup-file <filename>.

Backup filename macros

You can use the following placeholders within filenames:

• @v is replaced by Tasmota Version (backup & restore filenames)
• @d is replaced by Devicename (backup & restore filenames)
• @f is replaced by first Friendlyname1 (backup & restore filenames)
• @h is replaced by the Hostname from configuration data (backup & restore filenames)
  Note: This is the static hostname which is configured by the command Hostname, for real hostname from a device use macro the @H)
• @H is replaced by the live device hostname (only for http sources, backup & restore filenames)
  Note: This can be different to the configured hostname as this can contain also macros).source
• @F is replaced by the filename of MQTT request (only for MQTT sources, backup filenames only).
  This is usually the filename that Tasmota uses when saving the configuration in the WebUI.
• @t is replaced by Topic (backup & restore filenames)

Example:

decode-config -c my.conf -s tasmota-4281 --backup-file Config_@d_@v

This will create a file like Config_Tasmota_14.3.json (the part Tasmota and 14.3 will choosen related to your device configuration).

Save multiple backup at once

The --backup-file parameter can be specified multiple times to create different backup with different names and/or different formats at once:

decode-config -c my.conf -s tasmota-4281 -o Config_@d_@v -o [e-mail] -o [e-mail]

creates three backup files:

• Config_Tasmota_14.3.json using JSON format
• Backup_tasmota-4281.json using JSON format
• Backup_tasmota-4281.dmp using Tasmota configuration file format

Restore backup

Reading back a previously saved backup file, use the --restore-file <filename> parameter.

To restore the previously save backup file Config_Tasmota_14.3.json to device tasmota-4281 use:

decode-config -c my.conf -s tasmota-4281 --restore-file Config_Tasmota_14.3

Restore operation also allows placeholders @v, @d, @f, @h or @H like in backup filenames so we can use the same naming as for the backup process:

decode-config -c my.conf -s tasmota-4281 --restore-file Config_@d_@v

Note
Placeholders used in restore filenames only work as long as the underlying data of the device has not changed between backup and restore, since decode-config first read them from the config file or the device to replace it.

Restore subset of data

If you use the default JSON format for backup files you can also use files containing a subset of configuration data only.

Example: You want to change the data for location (altitude, latitude, longitude) only, create a JSON file location.json with the content

{
  "altitude": 0,
  "latitude": 48.85836,
  "longitude": 2.294442
}

Set this location for a device:

decode-config -c my.conf -s tasmota-4281 -i location

Note
When using JSON subsets on ESP32 chip types, always keep the key config_version in the JSON data, otherwise an error will occur stating that the file is for ESP82xx.

Hint
Keep the JSON-format valid e.g. when cutting unnecessary content from a given JSON backup file, consider to remove the last comma on same indent level:
Invalid JSON (useless comma in line 3: ...2.294442,):

{
"latitude": 48.85836,
"longitude": 2.294442,
}

valid JSON:

{
"latitude": 48.85836,
"longitude": 2.294442
}

Using subsets of data JSON files are powerfull possibilitiy to create various personal standard configuration files that are identical for all your Tasmota devices and that you can then reuse for newly configure Tasmotas.

Auto file extensions

File extensions are selected based on the file content and / or the --backup-type parameter. You don't need to add extensions to your file:

• If you omit the file extensions, one of .dmp, .bin or .json is used depending on the selected backup type
• If you omit the --backup-type parameter and the selected file name has one of the standard extensions .dmp, .bin or .json, the backup type is set based on the extension.

If you use your own extensions, deactivate the automatic extension using the --no-extension parameter and use the optional --backup-type parameter if neccessary.

Examples:

• decode-config --source tasmota-4281 --backup-file tasmota-4281.bin
  is identical with
  decode-config --source tasmota-4281 --backup-type bin --backup-file tasmota-4281
  In both cases the backup file tasmota-4281.bin is created.
• decode-config --source tasmota-4281 --restore-file tasmota-4281.json
  is identical with
  decode-config --source tasmota-4281 --restore-file tasmota-4281
  In both cases the backup file tasmota-4281.json will tried to restore (remember --backup-type json is the default)
• whereas
  decode-config --source tasmota-4281 --no-extension --restore-file tasmota-4281
  will fail if tasmota-4281 does not exist and
  decode-config --source tasmota-4281 --no-extension --backup-file tasmota-4281
  will create a json backup file named tasmota-4281 (without the extension).

Test your parameter

To test your parameter append --dry-run:

decode-config -s tasmota-4281 -i backupfile --dry-run

This runs the complete process but prevent writing any changes to a device or file.

Console outputs

Output to the console screen is the default when calling the program without any backup or restore parameter.
Screen output is suppressed when using backup or restore parameter. In that case you can force screen output with --output.

The console screen output supports two formats:

• JSON:
  This is identical with the backup/restore json file Format but printed on screen standard output.
• Tasmota command:
  This outputs the most (but not all!) configuration data as Tasmota web-console commands.

JSON format

The default console output format is JSON (optional you can force JSON backup format using --output-format json).

Example:

decode-config -c my.conf -s tasmota-4281 --group Wifi

will output data like

{
  ...
  "hostname": "%s-%04d",
  "ip_address": [
    "0.0.0.0",
    "192.168.12.1",
    "255.255.255.0",
    "192.168.12.1"
  ],
  "ntp_server": [
    "ntp.localnet.home",
    "ntp2.localnet.home",
    "192.168.12.1"
  ],
  "sta_active": 0,
  "sta_config": 5,
  "sta_pwd": [
    "myWlAnPaszxwo!z",
    "myWlAnPaszxwo!z2"
  ],
  "sta_ssid": [
    "wlan.1",
    "my-wlan"
  ],
  "web_password": "myPaszxwo!z",
  "webserver": 2
  ...
}

This also allows direct processing on the command line, e.g. to display all ntp_server only

decode-config -c my.conf -s tasmota-4281 | jq '.ntp_server'

outputs

[
  "ntp.localnet.home",
  "ntp2.localnet.home",
  "192.168.12.1"
]

Hint
JSON output contains all configuration data as default. To filter the JSON output by functional groups, use the -g or --group parameter.

Tasmota web command format

decode-config is able to translate the configuration data to (most all) Tasmota web commands. To output your configuration as Tasmota commands use --output-format command (or the short form -T cmnd).

Example:

decode-config -c my.conf -s tasmota-4281 --group Wifi --output-format cmnd

# Wifi:
  AP 0
  Hostname %s-%04d
  IPAddress1 0.0.0.0
  IPAddress2 192.168.12.1
  IPAddress3 255.255.255.0
  IPAddress4 192.168.12.1
  NtpServer1 ntp.localnet.home
  NtpServer2 ntp2.localnet.home
  NtpServer3 192.168.12.1
  Password1 myWlAnPaszxwo!z
  Password2 myWlAnPaszxwo!z2
  SSId1 wlan.1
  SSId2 my-wlan
  WebPassword myPaszxwo!z
  WebServer 2
  WifiConfig 5

Note
A very few specific commands are unsupported. These are commands from device-specific groups which are very dependent on the Tasmota program code whose implementation is very complex to keep in sync on Tasmota code changes - see also Generated Tasmota commands.

Use of 'Backlog' for Tasmota commands

Because individual Tasmota commands such as SetOption, WebColor etc. are often repeat themselves and might want to be used together, commands of the same name can be summarized using the Tasmota Backlog command. The decode-config parameter --cmnd-use-backlog enables the use of Tasmota Backlog.

With the use of --cmnd-use-backlog our example configuration

# Wifi:
  AP 0
  Hostname %s-%04d
  IPAddress1 0.0.0.0
  IPAddress2 192.168.12.1
  IPAddress3 255.255.255.0
  IPAddress4 192.168.12.1
  NtpServer1 ntp.localnet.home
  NtpServer2 ntp2.localnet.home
  NtpServer3 192.168.12.1
  Password1 myWlAnPaszxwo!z
  Password2 myWlAnPaszxwo!z2
  SSId1 wlan.1
  SSId2 my-wlan
  WebPassword myPaszxwo!z
  WebServer 2
  WifiConfig 5

becomes to

# Wifi:
  AP 0
  Hostname %s-%04d
  Backlog IPAddress1 0.0.0.0;IPAddress2 192.168.12.1;IPAddress3 255.255.255.0;IPAddress4 192.168.12.1
  Backlog NtpServer1 ntp.localnet.home;NtpServer2 ntp2.localnet.home;NtpServer3 192.168.12.1
  Backlog Password1 myWlAnPaszxwo!z;Password2 myWlAnPaszxwo!z2
  Backlog SSId1 wlan.1;SSId2 my-wlan
  WebPassword myPaszxwo!z
  WebServer 2
  WifiConfig 5

--cmnd-use-backlog gets really interesting for SetOptionxx, WebSensorxx, Sensorxx, Memxx, Gpioxx and more...

Filter by groups

The huge number of Tasmota configuration data can be overstrained and confusing, so the most of the configuration data are grouped into categories.

Filtering by groups affects the entire output, regardless of whether this is the screen or a json backup file. The output of a dmp or bin file cannot be filtered. These binary file types must always contain the entire configuration.

The following groups are available: Control, Display, Domoticz, Hdmi, Internal, Knx, Light, Management, Mqtt, Power, Rf, Rules, Sensor, Serial, Setoption, Settings, Shutter, System, Telegram, Timer, Usf, Wifi, Zigbee

These are similary to the categories on Tasmota Command Documentation.

To filter outputs to a subset of groups, use the -g or --group parameter, concatenating the groups you want, e. g.

decode-config -s tasmota-4281 -c my.conf --output-format cmnd --group Control Management MQTT Wifi

Usage examples

Using Tasmota binary configuration files

These examples use an online Tasmota device accessed over HTTP. The hostname of the Tasmota device is tasmota-2f5d44-4281

Backup an online Tasmota device via HTTP into a Tasmota configuration file

Use args to choice the file format

decode-config -c my.conf -s tasmota-2f5d44-4281 --backup-type dmp --backup-file Config_@d_@v

Use file extension to choice the file format

decode-config -c my.conf -s tasmota-2f5d44-4281 --backup-file Config_@[e-mail]

Restore a Tasmota configuration file to an online Tasmota device via HTTP

decode-config -c my.conf -s http://tasmota-2f5d44-4281 --restore-file Config_@[e-mail]

Using JSON editable file

These examples use an online Tasmota device that is accessed indirectly via MQTT.

In these examples, the MQTT server parameters are the same as those used by Tasmota itself:

• MQTT Server: mybroker.example.com
• MQTT Username: mqttuser
• MQTT Password: myBrokerPaszxwo!z
• Tasmota topic: tele/tasmota_2F5D44

Backup an online Tasmota device via MQTT into a JSON file

Use an unencrypted MQTT connection

MQTT server uses a non default port 42110

decode-config -s mqtt://mqttuser:myBrokerPaszxwo![e-mail]:42110/tele/tasmota_2F5D44 --backup-file Config_2f5d44-4281.json

Use SSL/TLS MQTT connection

Limit the configuration data to the groups Control, Management and SetOption

decode-config -s mqtts://mqttuser:myBrokerPaszxwo![e-mail] --fulltopic tele/tasmota_2F5D44 --backup-file Config_2f5d44-4281.json -g Control Management SetOption

Restore a JSON file to an online Tasmota device via MQTT

decode-config -s mqtts://mqttuser:myBrokerPaszxwo![e-mail]/tele/tasmota_2F5D44 --restore-file Config_2f5d44-4281.json

Use batch processing

Linux

for device in tasmota1 tasmota2 tasmota3; do ./decode-config -c my.conf -s $device -o Config_@d_@v; done

under Windows

for device in (tasmota1 tasmota2 tasmota3) do decode-config -c my.conf -s %device -o Config_@d_@v

will produce JSON configuration files for host tasmota1, tasmota2 and tasmota3 using friendly name and Tasmota firmware version for backup filenames.

File Formats

decode-config handles the following three file formats for backup and restore:

.dmp format

This is the original format used by Tasmota (created via the Tasmota web interface "Configuration" / "Backup Configuration" and can be read in with "Configuration" / "Restore Configuration". The format is binary encrypted.

This file format can be created by decode-config using the backup function (--backup-file <filename>) with the additional parameter --backup-type dmp.

.json format

This format uses the JSON notation and contains the complete configuration data in plain text, human readable and editable.

The .json format can be created by decode-config using the backup function (--backup-file <filename>) (for better identification you can append the optional parameter --backup-type json, but that's optional as json is the default backup format).

In contrast to the other two binary formats .dmp and .bin, this type of format also allows the partial modification of configurations.

Note
The keys used within the JSON file are based on the variable names of Tasmota source code in settings.h so they do not have the same naming as known for Tasmota web commands. However, since the variable names are self-explanatory, there should be no difficulties in assigning the functionality of the variables.

.bin format

This format is binary with the same structure as the .dmp format. The differences to .dmp are:

• .bin is decrypted
• .bin has 4 additional bytes at the end of the file

The .bin format can be created by decode-config using the backup function (--backup-file <filename>) with the additional parameter --backup-type bin.

This format is actually only used to view the configuration data directly in binary form without conversion.
It is hardly possible to change the binary data, since a checksum is formed over the data and this would have to be calculated and adjusted in case of any change.

Program parameter

For better reading each short written parameter using a single dash - has a corresponding long version with two dashes --, eg. --source for -s.
Note: Not even all double dash -- parameter has a corresponding single dash one - but each single dash variant has a double dash equivalent.

A short list of possible program args is displayed using -h or --help.

--full-help

For advanced help use parameter -H or --full-help.

usage: decode-config.py [-s <filename|host|url>] [-p <password>] [--fulltopic <topic>]
                        [--cafile <file>] [--certfile <file>] [--keyfile <file>]
                        [--insecure] [--keepalive <sec>] [-i <restorefile>]
                        [-o <backupfile>] [-t json|bin|dmp] [-E] [-e] [-F]
                        [--json-indent <indent>] [--json-compact] [--json-show-pw]
                        [--cmnd-indent <indent>] [--cmnd-groups] [--cmnd-sort]
                        [--cmnd-use-rule-concat] [--cmnd-use-backlog] [-c <configfile>]
                        [-S] [-T json|cmnd|command] [-g <groupname> [<groupname> ...]]
                        [-w] [--dry-run] [-h] [-H] [-v] [-V]

Backup/Restore Tasmota configuration data.

Source:
  Read/Write Tasmota configuration from/to

  -s, --source <filename|host|url>
                        source used for the Tasmota configuration (default: None).
                        Specify source type, path, file, user, password, hostname, port
                        and topic at once as an URL. The URL must be in the form
                        'scheme://[username[:password]@]host[:port][/topic]|pathfile'
                        where 'scheme' is 'file' for a tasmota binary config file,
                        'http' for a Tasmota HTTP web connection and 'mqtt(s)' for
                        Tasmota MQTT transport ('mqtts' uses a TLS connection to MQTT
                        server)
  -p, --password <password>
                        Web server password on HTTP source (set by Tasmota 'WebPassword'
                        command), MQTT server password in MQTT source (set by Tasmota
                        'MqttPassword' command) (default: None)

MQTT:
  MQTT transport settings

  --fulltopic <topic>   Optional MQTT transport fulltopic used for accessing Tasmota
                        device (default: )
  --cafile <file>       Enables SSL/TLS connection: path to a or filename of the
                        Certificate Authority certificate files that are to be treated
                        as trusted by this client (default None)
  --certfile <file>     Enables SSL/TLS connection: filename of a PEM encoded client
                        certificate file (default None)
  --keyfile <file>      Enables SSL/TLS connection: filename of a PEM encoded client
                        private key file (default None)
  --insecure            suppress verification of the MQTT server hostname in the server
                        certificate (default False)
  --keepalive <sec>     keepalive timeout for the client (default 60)

Backup/Restore:
  Backup & restore specification

  -i, --restore-file <restorefile>
                        file to restore configuration from (default: None).
                        Replacements: @v=firmware version from config, @d=devicename,
                        @f=friendlyname1, @h=hostname from config, @H=device hostname
                        (http source only), @t=topic
  -o, --backup-file <backupfile>
                        file to backup configuration to, can be specified multiple times
                        (default: None). Replacements: @v=firmware version from config,
                        @d=devicename, @f=friendlyname1, @h=hostname from config,
                        @H=device hostname (http source only), @F=configuration filename
                        from MQTT request (mqtt source only), @t=topic
  -t, --backup-type json|bin|dmp
                        backup filetype (default: 'json')
  -E, --extension       append filetype extension for -i and -o filename (default)
  -e, --no-extension    do not append filetype extension, use -i and -o filename as
                        passed
  -F, --force-restore   force restore even configuration is identical

JSON output:
  JSON format specification. To revert an option, insert "dont" or "no" after "json",
  e.g. --json-no-indent, --json-dont-show-pw

  --json-indent <indent>
                        pretty-printed JSON output using indent level (default: 'None').
                        -1 disables indent.
  --json-compact        compact JSON output by eliminate whitespace
  --json-show-pw        unhide passwords (default)

Tasmota command output:
  Tasmota command output format specification. To revert an option, insert "dont" or
  "no" after "cmnd", e.g. --cmnd-no-indent, --cmnd-dont-sort

  --cmnd-indent <indent>
                        Tasmota command grouping indent level (default: '2'). 0 disables
                        indent
  --cmnd-groups         group Tasmota commands (default)
  --cmnd-sort           sort Tasmota commands (default)
  --cmnd-use-rule-concat
                        use rule concatenation with + for Tasmota 'Rule' command
  --cmnd-use-backlog    use 'Backlog' for Tasmota commands as much as possible

Common:
  Optional arguments

  -c, --config <configfile>
                        program config file - can be used to set default command
                        parameters (default: None)
  -S, --output          display output regardsless of backup/restore usage (default do
                        not output on backup or restore usage)
  -T, --output-format json|cmnd|command
                        display output format (default: 'json')
  -g, --group <groupname>
                        limit data processing to command groups ['Control', 'Display',
                        'Domoticz', 'Hdmi', 'Internal', 'Knx', 'Light', 'Management',
                        'Mqtt', 'Power', 'Rf', 'Rules', 'Sensor', 'Serial', 'Setoption',
                        'Settings', 'Shutter', 'System', 'Telegram', 'Timer', 'Usf',
                        'Wifi', 'Zigbee'] (default no filter)
  -w, --ignore-warnings
                        do not exit on warnings. Not recommended, used by your own
                        responsibility!
  --dry-run             test program without changing configuration data on device or
                        file

Info:
  Extra information

  -h, --help            show usage help message and exit
  -H, --full-help       show full help message and exit
  -v, --verbose         produce more output about what the program does
  -V, --version         show program version (and config version if --source is given)
                        and exit

The arguments -s <filename|host|url> must be given.

Args that start with '--' (eg. -s) can also be set in a config file (specified via -c).
Config file syntax allows: key=value, flag=true, stuff=[a,b,c] (for details, see syntax
at https://goo.gl/R74nmi). If an arg is specified in more than one place, then
commandline values override config file values which override defaults.

Note
If you miss parameters here that are already in use, don't worry, they are still there.
For details see Obsolete parameters

Parameter notes

• Filename replacement macros @h and @H:
  • @h The @h replacement macro uses the hostname configured with the Tasomta Wifi Hostname <host> command (defaults to %s-%04d). It will not use the network hostname of your device because this is not available when working with files only (e.g. --source <filename> as source). To prevent having an useless % in your filename, @h will not replaced by hostname if this contains '%' characters.
  • @H If you want to use the network hostname within your filename, use the @H replacement macro instead - but be aware this will only replaced if you are using a network device as source (<hostname>, <ip>, <url>); it will not work when using a file as source (<filename>)

Obsolete parameters

The parameters listed here continue to work and are supported, but are no longer listed in the parameter list:

Obsolete source parameters

The following source selection parameters are completely replaced by a single used -s or --source parameter; use -s or --source with a http-url:

• -f, --file, --tasmota-file, tasmotafile <filename>
  file used for the Tasmota configuration (default: None)'
• -d, --device, --host <host|url>
  hostname, IP-address or url used for the Tasmota configuration (default: None)
• -P, --port <port>
  TCP/IP port number to use for the host connection (default: 80)
• -u, --username <username>
  host HTTP access username (default: admin)

Obsolete JSON formating parameters

• --json-unhide-pw same as --json-show-pw
• --json-hide-pw same as --json-dont-show-pw
• --json-sort sorts JSON output (this is the default)
• --json-unsort prevents JSON sorting

Generated Tasmota commands

Details below shows the Tasmota command generated by decode-config:

• Supported
  These commands will be generated using parameter --output-format cmnd.
• Ad hoc
  These Tasmota commands are used for immediate action and do not change settings - so these cannot be created.
• Unsupported
  These Tasmota commands are unsupported and not implemented in decode-config

Group	Supported	Ad hoc	Unsupported
Control	BlinkCount	Backlog
	BlinkTime	Buzzer
	ButtonDebounce	FanSpeed
	DevGroupName	LedPower
	DevGroupShare
	DevGroupTie
	Interlock
	LedMask
	LedPwmMode<x>
	LedPwmOn
	LedPwmOff
	LedState
	Power<x>
	PowerLock<x>
	PowerOnState
	PulseTime<x>
	SwitchDebounce
	SwitchMode<x>
	Webbutton<x>
	WCAEC2
	WCAECDSP2
	WCAECValue2
	WCAELevel2
	WCAGCGain2
	WCAWB2
	WCAWBGain2
	WCBPC2
	WCBrightness2
	WCClock2
	WCColorbar2
	WCContrast2
	WCDCW2
	WCFeature2
	WCFlip2
	WCGainCeiling2
	WCGammaCorrect2
	WCLensCorrect2
	WCMirror2
	WCResolution2
	WCRtsp2
	WCSAuth2
	WCSaturation2
	WCSpecialEffect2
	WCStream2
	WCWBMode2
	WCWPC2
Management	DeepSleepTime	Delay
	DeviceName	Gpios
	Emulation	I2Cscan
	FriendlyName<x>	Modules
	Gpio<x>	Reset
	I2CDriver<x>	Restart
	Ifx	State
	IfxBucket	Status
	IfxHost	Upgrade
	IfxPassword	Upload
	IfxPort	SSPMLog2
	IfxUser	SSPEnergy2
	IfxRP	SSPHistory2
	IfxPeriod	SSPScan2
	IfxSensor	SSPIamHere2
	L1MusicSync
	LogHost
	LogPort
	Module
	Module2
	MqttLog
	NtpServer<x>
	OtaUrl
	Pwm<x>
	PwmFrequency
	PwmRange
	RtcNtpserver
	SaveData
	SerialLog
	Sleep
	SSPMDisplay2
	SysLog
	Template
	Time
	TimeSTD
	TimeDST
	Timezone
	TouchThres2
	TuyaMCU
	TuyaTempSetRes
	WebLog
	WebTime
WiFi	CORS	AP
	DnsTimeout	Ping<x>
	Ethernet2	WebSend
	EthAddress2	Publish
	EthClockMode2	Publish2
	EthType2
	EthIPAddress2
	EthSubnetmask2
	EthGateway2
	EthDNSServer2
	EthDNSServer22
	Hostname
	IPAddress<x>
	Password<x>
	RgxAddress
	RgxNAPT
	RgxPassword
	RgxSsid
	RgxState
	RgxSubnet
	Ssid<x>
	WebPassword
	WebCanvas
	WebColor<x>
	WebRefresh
	WebSensor<x>
	WebServer
	Wifi
	WifiConfig
	WifiPower
MQTT	ButtonRetain	Subscribe
	ButtonTopic	Unsubscribe
	FullTopic
	GroupTopic<x>
	InfoRetain
	MqttClient
	MqttFingerprint
	MqttHost
	MqttKeepAlive
	MqttPassword
	MqttPort
	MqttRetry
	MqttUser
	MqttTimeout
	MqttWifiTimeout
	PowerRetain
	Prefix<x>
	SensorRetain
	StateRetain
	StateText<x>
	StatusRetain
	SwitchRetain
	SwitchTopic
	TelePeriod
	Topic
Rules	CalcRes	Add<x>
	Mem<x>	Event
	Rule<x>	Mult<x>
	Script	RuleTimer<x>
		Scale<x>
		Sub<x>
		Var<x>
Telegram	TmState
Timer	Latitude
	Longitude
	Timers
	Timer<x>
Sensor	Altitude	Bh1750MTime<x>	AdcParam
	AmpRes	GlobalHum
	AS3935AutoNF	GlobalTemp
	AS3935AutoDisturber	Sensor27
	AS3935AutoNFMax	Sensor50
	AS3935MQTTEvent	Sensor52
	AS3935NFTime	Sensor53
	AS3935NoIrqEvent	Sensor601
	AS3935DistTime
	AS3935SetMinStage
	Bh1750Resolution<x>
	Counter<x>
	CounterDebounce
	CounterDebounceLow
	CounterDebounceHigh
	CounterType<x>
	HumOffset
	HumRes
	PressRes
	OT_Flags
	OT_Save_Setpoints
	OT_TBoiler
	OT_TWater
	Sensor13
	Sensor15
	Sensor18
	Sensor20
	Sensor29
	Sensor34	Sensor34 1,Sensor34 2
	Sensor40
	Sensor54
	Sensor68
	Sensor96
	Shift595DeviceCount
	SpeedUnit
	TempRes
	TempOffset
	VoltRes
	WattRes
	WeightRes
	Wiper<x>
Power	AmpRes	CurrentSet
	CurrentCal	FrequencySet
	CurrentHigh	ModuleAddress
	CurrentLow	PowerSet
	EnergyRes	Status8
	EnergyToday	Status9
	EnergyTotal	VoltageSet
	EnergyYesterday
	FreqRes
	MaxPower
	MaxPowerHold
	MaxPowerWindow
	PowerCal
	PowerDelta
	PowerHigh
	PowerLow
	Tariff<x>
	VoltageCal
	VoltageHigh
	VoltageLow
	VoltRes
	WattRes
Usf	UsfFTP		UsfType
			UsfSize
			UsfFree
			UsfDelete
			UsfRename
			UsfRun
			UsfServe
Light	DaliWeb	Channel<x>	Color<x>
	DimmerRange	CT	Dimmer
	DimmerStep	CTRange
	Fade	HsbColor
	LedTable	Led<x>
	Pixels	Palette
	PWMDimmerPWMs	White
	RGBWWTable	VirtualCT
	Rotation
	Scheme
	ShdLeadingEdge
	ShdWarmupBrightness
	ShdWarmupTime
	Speed
	StepPixels
	Wakeup
	WakeupDuration
	ZCDimmerSet
RF	RfProtocol	RfRaw	RfCode
	RfTimeOut		RfHigh
			RfHost
			RfKey<x>
			RfLow
			RfSync
IR		IRsend<x>
		IRhvac
SetOption	SetOption<x>
Serial	Baudrate	SerialSend<x>
	ModbusBaudrate	SSerialSend<x>
	ModbusSerialConfig	TCPStart
	SBaudrate	TuyaSend<x>
	SerialConfig
	SerialDelimiter
	SSerialConfig
	SSerialMode
	TCPBaudrate
	TCPConfig
Domoticz	DomoticzIdx<x>
	DomoticzKeyIdx<x>
	DomoticzSensorIdx<x>
	DomoticzSwitchIdx<x>
	DomoticzUpdateTimer
KNX	KNX_ENABLED	KnxTx_Cmnd<x>	KNX_PA
	KNX_ENHANCED	KnxTx_Val<x>	KNX_GA<x>
			KNX_CB<x>
Display	DisplayAddress	Display
	DisplayDimmer	DisplayText
	DisplayILIMode
	DisplayInvert
	DisplayMode
	DisplayModel
	DisplayRefresh
	DisplaySize
	DisplayType
	DisplayRotate
	DisplayCols
	DisplayRows
	DisplayFont
	DisplayWidth
	DisplayHeight
Shutter	ShutterButton<x>	ShutterClose<x>
	ShutterCalibration<x>	ShutterFrequency<x>
	ShutterCloseDuration<x>	ShutterOpen<x>
	ShutterEnableEndStopTime<x>	ShutterSetClose<x>
	ShutterInvert<x>	ShutterStop<x>
	ShutterInvertWebButtons<x>	ShutterStopClose<x>
	ShutterLock<x>	ShutterStopOpen<x>
	ShutterMode<x>	ShutterStopPosition<x>
	ShutterMotorDelay<x>	ShutterStopToggle<x>
	ShutterMotorStop	ShutterStopToggleDir<x>
	ShutterOpenDuration<x>	ShutterToggle<x>
	ShutterPosition<x>	ShutterToggleDir<x>
	ShutterPWMRange<x>
	ShutterRelay<x>
	ShutterSetHalfway<x>
	ShutterTiltConfig<x>
Telegram	TmChatId	TmPoll
	TmState	TmSend
	TmToken
Zigbee	BatteryPercentage	ZbBind
	ZbConfig	ZbForget
		ZbLight
		ZbName
		ZbPermitJoin
		ZbPing
		ZbSend
		ZbStatus<x>
		ZbUnbind
Bluetooth		- all -
Stepper Motors		- all -
MP3 Player		- all -
Hdmi	HdmiAddr
	HdmiType

Notes
¹ Sensor60 13 sets the latitude/longitude, use Latitude and Logitude command instead.
² ESP32 only

Program return codes

decode-config returns the following codes:

• 0 - successful:
  The process has successful finished

• 1 = restore skipped:
  Unchanged data, restore not executed

• 2 = program argument error:
  Wrong program parameter used (data source missing)

• 3 = file not found

• 4 = data size mismatch:
  The data size read from source does not match the excpected size

• 5 = data CRC error:
  The read data contains wrong CRC

• 6 = unsupported configuration version:
  The source data contains data from an unsupported (Sonoff-)Tasmota version

• 7 = configuration file read error:
  There was an error during read of configuration source file

• 8 = JSON file decoding error:
  There was an error within the read JSON file

• 9 = restore file data error:
  Error occured by writing new binary data

• 10 = device data download error:
  Source device connected but configuration data could not be downloaded (WebServer missing, disabled)

• 11 = device data upload error:
  Source device connected but configuration data could not be uploaded (WebServer missing, disabled, connection lost...)

• 12 = invalid configuration data:
  The configuration data source contains invalid basic data (wrong platform id...)

• 20 = python module missing:
  A neccessary python library module is missing

• 21 = internal error:
  An unexpected internal error occured

• 22 = HTTP connection error:
  Source device HTTP connection lost or unavailable

• 23 = MQTT connection error:
  MQTT server connection error

• 24... = python library exit code:
  An unexpected internal library error occured

• 4xx/5xx = HTTP errors