movedat Configuration File

All of movedat's settings can be controlled using command line options.  You can also use configuration files to specify commonly used settings.

Locations and Load Order

On startup, movedat will attempt to load configuration information from three locations: a system-wide file, a home directory file, or a path given with command line option -f.

Mac / Unix Windows
System /etc/ %SystemRoot%\
Home $HOME/ %AppData%\DEI\
-f <path> <path> <path>

Settings will be honored in the following order of increasing precedence: built-in defaults, system configuration file, home configuration file, command line configuration file, then command line options.

You can disable all configuration files by using a blank path with -f.  This ensures that only built-in defaults and command line options are used.  For example:

movedat -f "" ...

Note that if the "-f" option is not empty, then the settings in the specified file will be merged with those of the System and Home configurations as described above.  Only a blank "-f" prevents those configuration files from being loaded.


The configuration file must encoded as UTF-8 (no BOM) or ASCII.  Each line in a configuration file must consist of up to 1022 bytes of text.  For Windows systems, lines should end with CR-LF.  For all other systems, lines should end with LF.

A line whose first byte is a hash (#) character or which consists entirely of spaces and tabs is ignored.  Leading spaces and tabs on an otherwise valid line are skipped.  Valid lines have one of the following formats:

<variable>=<value> <variable> <value>

The second form ignores any leading white space in <value>.  Variable names are not case sensitive.  See the enclosed file for an example.

Configuration variables, along with their corresponding command line options, are described in the Options section.

A configuration file must contain the following line to work with this version of movedat:

MovedatConfigVersion 1

Do not change or remove that value as it defines the format of the file and movedat may reject or incorrectly parse the file if it has a different number.

Values are set in the order they are read.  If you are enabling diagnostics, it is recommended that you do this as early as possible so that you can see diagnostics for the settings that follow.