A command line tool for working with DDFs.

npm install -g @deconz-community/cli

ddf-tools --help

npx @deconz-community/cli --help

pnpm preview --help

You can see the help by running:

ddf-tools --help

The validator command will validate the DDFs in the given directory. Make sure both the DDF and the Generics files are present in the directory. You can use the flag --no-skip to validate the DDFs with option ddfvalidate set to false.

ddf-tools validator --help
ddf-tools validator --directory /path/to/ddf

The bundler command will bundle the DDFs from the given json DDF source file. Make sure the DDFs are valid before bundling them.

ddf-tools bundler --help
ddf-tools bundler -o ./output/ devices/ikea/starkvind_air_purifier.json
ddf-tools bundler -o ./output/ devices/
ddf-tools bundler --upload --store-token <token> devices/

The path to the json DDF source file or a directory containing the json DDF source files. If a directory is provided, all json files in the directory will be bundled.

The directory where all generic files are located. If not provided, the bundler will look for the generic directory in parent directories.

The directory where the bundled DDFs will be saved. Defaults to the DDF directory.

Skip the validation of the DDFs.

The private key to sign the DDFs with. If upload enabled your private key will be used to sign the DDFs.

Upload the DDFs to the DDF server.

The url of the DDF server to upload the DDFs to. By default it's using the global DDF server at https://ddf.cryonet.io.

The token to authenticate with the DDF server.

Status of the bundle (alpha, beta, stable) (default: "alpha")

Method to use to get the last modified date of the files (gitlog, mtime, ctime) (default: "gitlog")

Enable debug mode.

The bulk command will run various operation on DDF files.

The uuid operation will generate a new UUID for each DDF file in the given directory. Limited to 100 files at a time.

ddf-tools bulk uuid --store-token <token> ./devices/