Check out this video tutorial to get started.

What is happening under the hood of das element?

The setup file contains the information about which config file to use for the software.
The config file contains the global configuration for all libraries (naming convention, file structure, …)
A library contains a collection of elements. It exists of the library file and the database for this one library.

~ (tilde) is your users home directory.
Linux/macOS: /home/myuser
Windows: C:\Users\myuser / %userprofile%

default location setup file	`~/.das-element/setup.ini`
default location config file or custom location	`~/.das-element/das-element.conf`

Here are some common file path locations that you might need:

type of file	description	path

type of file	description	path
setup file	Default location setup file This file references to the config file.	`~/.das-element/setup.ini` or environment variable: `DASELEMENT_CONFIG_PATH`
config file	Default location config file or custom location	`~/.das-element/das-element.conf` ^{or some custom location}
variables file	File to store environment variables that are loaded on software startup	`~/.das-element/variables.env`
models	location for machine learning models	`~/.das-element/models`
log files	for error logs etc.	`~/.das-element/logs`
preview files	The software creates previews of your elements to increase performance. If you want to remove the previously created previews, just remove the temp folder. It automatically removes files older than 14 days.	Linux: `~/tmp/das-element` MacOS: `/$TMPDIR/das-element` Windows: `%temp%/das-element`

Setup file

The setup file contains the information about which config file to use for the software.

The idea is that you can switch between different setups. Each setup could have a different folder structure and naming convention. By using the different setup files you can separate them completely.

It also stores other user specific information, e.g which machine learning models should be actively used.

The file is stored in your local user home directory

Linux/Mac
~/.das-element/setup.ini

Windows
%userprofile%/.das-element/setup.ini

As an alternative you can set the environment variable to specify the config file location.

Order of validation:

Environment Variable (DASELEMENT_CONFIG_PATH)
setup file (setup.ini)

If you want to force the creation of a new setup, simply delete the setup file.

Config file

The config file contains the global configuration of all libraries associated with this configuration.
Here you can define the file structure and naming convention that are shared across all of the linked libraries.

When creating your new setup for the software you can specify the file location.
The file can be stored anywhere. The setup file referenced to this config file.

By default it is stored in your local user home directory

Linux/Mac
~/.das-element/das-element.conf

Windows
%userprofile%/.das-element/das-element.conf

Create new config

The dialog to create a new configuration (welcome screen) will automatically appear the first time you start the application, or if a configuration file specified in the setup.ini file or by the environment variable DASELEMENT_CONFIG_PATH cannot be found. To create a new configuration, navigate to:

Settings → Global → Path to config → plus-icon button (Create new config)

Library file

A library contains a collection of elements.
The library files are saved by default in a hidden folder .config in library root location.

Each library exists of two parts:

Library file
contains the configuration of the library, like value overwrites and transcoding templates.
{library_name}.lib - file content is JSON format
Database
holds all information about the elements of this library
For file based database (SQLite): {library_name}.db

Define the file structure in the global settings and overwrite values or path patterns that are relevant for this library. This way, the naming convention stays consistent through all libraries, but you can control individual parts by overwriting values depending on this specific library.

Machine Learning Model

If you want to use the smart tagging feature you need to install machine learning models. These models have been trained for classification of the categories. Each model is trained on a specific task.

The models will be trained by das element for you. Over time these models will improve, will contain more categories and help to tag your library even further and better.

The models have the file extension {model_name}.wit

By default it is stored in your local user home directory

Linux/Mac
~/.das-element/models

Windows
%userprofile%/.das-element/models