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.

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 the 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 Registry. This value defines which folder the configuration files are stored in:

  • 1 - program's 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 the specified folder or from the folder containing the specified .ini file. In both cases the specified name must be the 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 that 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>" <registration_code>

Register the program with the specified user name/registration code.

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

backup <backup_file_name.zip>

Back up the current configuration into the specified ZIP archive. The backup_file_name.zip must be the fully qualified file name. If the file with such name already exists in the 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 until the backup process finishes (it may take sufficient time, and proceeding to next script commands before the backup file will be created may cause ambiguities).

restore <backup_file_name.zip>

Replace the current configuration from the specified backup ZIP archive created earlier. The backup_file_name.zip must be the 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 until the restoration process finishes (it may take sufficient time, and proceeding to next script commands before all configuration data will be replaced may cause configuration's corruption and lead to program's malfunction).

dp "<desktop_profile_name>"

Apply the desktop profile with the specified name. <desktop_profile_name> is a placeholder for the 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