Auto-Import Configuration

The Auto-Import feature can import all GPS files from a particular location on program startup, or when the "File/Auto Import" menu or the toolbar icon are selected. AutoImport behavior is configured in the Auto Import section of the configuration dialog.

Options

External Commands

Some devices may have a custom tool which can non-interactively extract data from the device. A command can be automatically run before ZTGPS attempts to complete the import step. It is the job of this command to provide data, either in a directory, or on its standard output.

The external command is not run in a shell, but certain POSIX-shell type features are available in the string provided to ZTGPS, such as variable substitution, tilde (~) expansion, wildcard globbing, quoting, and process substitution.

The external command is run asynchronously. The tracks may not appear for several moments after using the Auto Import feature if the external process does not complete immediately. If the external tool does not finish within the Timeout value, ZTGPS will kill the process.

The stdout checkbox will cause ZTGPS to read the standard output of the command as if it was a GPS file in one of the supported formats. Other files present in the AutoConfig directory will still be read as normal, but a pattern which does not match any files can be used to prevent this behavior if needed.

Note that files matching the Pattern will be imported whether or not they were produced by the external command. if the command writes to stdout, the pattern can be set to an empty string to prevent accidentally reading files.