uberAgent’s configuration file supports several advanced syntax features.

Windows

ConfigInclude

A @ConfigInclude directive includes another configuration file. The other file is identified by name (without path) and must reside in the same directory as the configuration file including it. The additional platform parameter may be used to conditionally include a file on the selected platform (Windows or macOS). Platform matching is case-insensitive.

Examples:

#Include on all platforms
@ConfigInclude other-file.conf

# Include on Windows only
@ConfigInclude windows-specific.conf platform=Windows

PATH_REGEX

PATH_REGEX stands for a regex in which environment variables can be used. It is matched against a file system path. The following rules apply:

• Environment variables (enclosed in percent signs, e.g., %ProgramFiles%) are expanded first, regex matching happens second.
• Paths are specified as regular expressions.
• Backslashes must be escaped by prepending a second backslash.
• Matching is case-insensitive.
• Specifying only the file name without the full path works but is not recommended.

Agents on All Operating Systems

PROCESS_NAME_REGEX

PROCESS_NAME_REGEX stands for a regex that is matched against a process name. The following rules apply:

• Backslashes must be escaped by prepending a second backslash.
• Matching is case-insensitive.
• Only the file name is used for matching, not the full path.

URL_REGEX

URL_REGEX stands for a regex that is matched against a URL. The following rules apply:

• Backslashes must be escaped by prepending a second backslash.
• Matching is case-sensitive.

Format of the URLs matched against URL_REGEX:

• Origin and path (without query segment), e.g.: https://uberagent.com/download/
• Port numbers are stripped from the URL if they match the default port number.