Program Command Line Parameters

ActualWindowManagerCenter.exe can accept commands via command line to ease the administrative installation on multiple machines using shell command scripts.

The command line structure is following:

ActualWindowManagerCenter.exe <command> [command-options]

Important Note!
You can use only a single command per call. If you need to invoke several commands in a script - run the executable several times, each time with a different command (see the sample script).

The ActualWindowManagerCenter.exe executable accepts the following commands:

Command Description
i<+|-> [-all]

Enable/disable the tray icon for a current user.

The -all option enables/disables the tray icon for all users of the current workstation (it requires to run this command as administrator).

Important Note!
When using in shell scripts along with the restore command, it is recommended to run this command after the restore command; otherwise, changes made by this command will be overwritten from a backup copy.

s<+|-> [-all]

Enable/disable loading at startup for a current user.

The -all option enables/disables the loading at startup for all users of the current workstation (it requires to run this command as administrator).

l<+|-> [-all]

Enable/disable running the library from the installation folder for a current user.

The -all option enables/disables the option for all users of the current workstation (it requires to run this command as administrator).

CFL <1|2|3|"custom_folder"|-> [-all]

Add/modify/remove the "ConfigFilesLocation" value in the system Registry. This value defines which folder the configuration files are stored in:

  • 1 - Actual Window Manager installation folder
  • 2 - %AppData% folder in the "All Users" user profile
  • 3 - %AppData% folder in the current user profile (default behavior)
  • "custom_folder" - a full path (in quotes) to an arbitrary existing folder (either local or network)
  • - (default value) - removes the "ConfigFilesLocation" value from the Registry and restores the default behavior

The -all option enables/disables the option for all users of the current workstation (it requires to run this command as administrator).

By default, the program looks for this value in the HKEY_CURRENT_USER Registry branch, then in the HKEY_LOCAL_MACHINE Registry branch.

c ["<folder_name>"|"<ini_file_name>"]

Reload the configuration files from a specified folder or from a folder containing the specified .ini file. In both cases the specified name must be a fully qualified file name. If the specified folder exists, Actual Window Manager will search it for appropriate configuration files and load the found files.

Important Note!
Actual Window Manager clears its current settings before reloading so if the specified folder does not exist or does not contain some of the required files then certain settings will remain empty. See the list of required files below:

If the folder/file name is omitted - this command forces Actual Window Manager to reload the current configuration.

r "<user_name>" <license_key>

Register the program with a specified user name/license key.

To register the program for all users in the system, run this command as administrator.

backup "<backup_file_name.zip>"

Back up the current configuration into a specified ZIP archive. The backup_file_name.zip must be a fully qualified file name. If the file with such name already exists in a specified folder - it will be overwritten.

This command works the same as the Backup button.

Important Note!
When using in shell scripts, it is strongly recommended to run this command prepended with START /WAIT to pause the script execution until the backup process finishes (it may take sufficient time, and proceeding to next script commands before the backup file is created may cause ambiguities).

restore "<backup_file_name.zip>"

Replace the current configuration from a specified backup ZIP archive created earlier. The backup_file_name.zip must be a fully qualified file name. If the specified file does not exist, or it's not a valid ZIP archive, or it does not contain valid configuration files - the current configuration will remain intact.

This command works the same as the Restore button.

Important Note!
When using in shell scripts, it is strongly recommended to run this command prepended with START /WAIT to pause the script execution until the restoration process finishes (it may take sufficient time, and proceeding to next script commands before all configuration data is restored may cause configuration corruption and lead to malfunction of the program).

dp "<desktop_profile_name>"

Apply a desktop profile with a specified name. <desktop_profile_name> is a placeholder for a real profile's name. Please note that if the name contains spaces then you must enclose it in quotes.

This command works the same as the Activate profile button.

unload

Shut down the Control Center.

This command works the same as the Unload Actual Window Manager button or the Exit context menu item.

suspend

Pause the running Control Center.

This command works the same as the Pause Actual Window Manager button or the Pause context menu item.

resume

Resume the paused Control Center.

This command works the same as the Resume Actual Window Manager button or the Resume context menu item.

Commands and command options are case-insensitive.

Sample Script