How to change Supremo options using a command line

The command line is a useful tool for automating the setting of certain Supremo parameters both on Windows and macOS.

You can follow these simple steps to change the Supremo options.

Windows

Start a command prompt with administrative privileges from the folder that contains the Supremo executable, for example: C:\Program Files (x86)\Supremo

Then type the command of the desired function and press enter.

Start a remote connection

  • option 1: Supremo.exe ID

entering the password when the popup window appears.

  • option 2: Supremo.exe ID Password

The abovementioned strings can be alternatively used with or without administrative privileges.

Entering a secondary password
echo mypassword | Supremo.exe -set-password

replacing mypassword with the desired secondary password

Entering the license code
echo XXXXX-XXXXX-XXXXX | Supremo.exe -set-license

by replacing XXXXX-XXXXX-XXXXX-XXXXX with the desired license code

Remove license code
Supremo.exe -remove-license

Configure language

Supremo.exe /set-language ‘en’ | ‘it’ | ‘es’ | ‘ru’ | ‘pt’ | ‘br’ | ‘fr’ | ‘pl’ | ‘de’ | ‘bg’ | ‘bs’ | ‘ca’ | ‘cs’ | ‘el’ | ‘et’ | ‘hi’ | ‘hr’ | ‘hu’ | ‘hy’ | ‘ja’ | ‘lt’ | ‘nl’ | ‘no’ | ‘ro’ | ‘sl’ | ‘sv’ | ‘uk’ | ‘zh-Hans’ | ‘zh-Hant’

Connection confirmation request
Supremo.exe -ask-authorization 0|1 [or alternatively from version 4.8.4 Supremo.exe -request-user-authorization 0|1]

  • 0 disables the connection confirmation request
  • 1 enables it

To change the duration of “Request user authorization” (default is 30 and maximum is 300 seconds):

Supremo.exe -display-request-for value

To allow authorization after timeout request:

Supremo.exe -allow-after-request-timeout 0|1

Choice of Update Channel
Supremo.exe -update-channel default|stable|beta

  • stable selects the stable channel
  • beta selects the beta channel
  • default selects the channel of the used version (Stable or Beta)

Enabling or disabling automatic installation of new versions
Supremo.exe -update-autoinstall off|all

  • off disables automatic update
  • all enables it

Enabling or disabilng the Supremo startup at the system boot
Supremo.exe -servicesetup

It enables the “Start Supremo at system boot (unattended access)” feature

net stop SupremoService
SupremoService.exe /uninstall /silent

It disables the feature

Enabling the password protecting the configuration of Supremo options

echo mypasswordconfiguration | Supremo.exe -set-configuration-password

Setting password strength or disabling password

Supremo.exe -password-strength 6|8|10|disabled

Add password

echo password | Supremo.exe -add-password description

Set Allowed IDs

Supremo.exe -set-whitelist 123456789,987654321,012345678,…

Remove Allowed IDs

Supremo.exe -remove-whitelist

Enable feature “Close to tray menu”

Supremo.exe -close-to-tray 0|1

Enable feature “Show notes window after each session”

Supremo.exe -show-notes-after-session 0|1

Enable multisession support

Supremo.exe -enable-multisession 0|1

Configuring the Computer Name

Supremo.exe -set-computer-name XXXXXXX

Note: please use strings that consist of 1 to 50 characters. The allowed characters are alphanumeric characters, hyphen, underscore, curly braces, tilde, parentheses, and the special characters “@”, “#”, “$”, “%”, “^”, and “&”.>

Configuring Proxy options

Supremo.exe -set-proxy-mode None|Automatic|Manual

If “Manual” is selected you also need to setup:

  • Supremo.exe /set-proxy-mode Manual /set-proxy-type Secure|Http /set-proxy-address address /set-proxy-port port

if you also need to setup Username and Password:

  • echo password | Supremo.exe /set-proxy-mode Manual /set-proxy-type Secure|Http /set-proxy-address address /set-proxy-port port /set-proxy-username username /set-proxy-password

Enable option “Run Supremo under SYSTEM account”

Supremo.exe -run-as-sys 0|1

Start a connection from command line sending the 2FA code

Supremo.exe <id> <password> <totp>

Example:

“C:\Program Files (x86)\Supremo\Supremo.exe” 234123444 qwerty 563245

Enable/Disable 2FA

Enable (encoded secret code will be written to STDOUT)

“C:\Program Files (x86)\Supremo\Supremo.exe” /enable-2fa

You can create a batch file with the following strings to visually see the STDOUT:

@echo off

for /f “delims=” %%i in (‘”C:\Program Files (x86)\Supremo\Supremo.exe” /enable-2fa’) do set ENCODED_SECRET=%%i

echo Encoded secret is: %ENCODED_SECRET%

pause

Disable

“C:\Program Files (x86)\Supremo\Supremo.exe” /disable-2fa

Obtaining the Supremo ID via command line

(ID will be written to STDOUT)

“C:\Program Files (x86)\Supremo\Supremo.exe” /get-id

You can create a batch file with the following strings to visually see the STDOUT:

@echo off

for /f “delims=” %%i in (‘”C:\Program Files (x86)\Supremo\Supremo.exe” /get-id’) do set SUPREMO_ID=%%i

echo Supremo ID is: %SUPREMO_ID%

pause

MacOS

Start a remote connection

  • /Applications/Supremo.app/Contents/MacOS/Supremo RemoteID
  • /Applications/Supremo.app/Contents/MacOS/Supremo RemoteID Password

Entering a secondary password

echo PASSWORD | /Applications/Supremo.app/Contents/MacOS/Supremo -set-password

Entering the license code

echo XXXXX-XXXXX-XXXXX-XXXXX | /Applications/Supremo.app/Contents/MacOS/Supremo -set-license

by replacing XXXXX-XXXXX-XXXXX-XXXXX with the desired license code

Remove license code
/Applications/Supremo.app/Contents/MacOS/Supremo -remove-license

Configure language

/Applications/Supremo.app/Contents/MacOS/Supremo -set-language ‘en’ | ‘it’ | ‘es’ | ‘ru’ | ‘pt’ | ‘br’ | ‘fr’ | ‘pl’ | ‘de’ | ‘bg’ | ‘bs’ | ‘ca’ | ‘cs’ | ‘el’ | ‘et’ | ‘hi’ | ‘hr’ | ‘hu’ | ‘hy’ | ‘ja’ | ‘lt’ | ‘nl’ | ‘no’ | ‘ro’ | ‘sl’ | ‘sv’ | ‘uk’ | ‘zh-Hans’ | ‘zh-Hant’

Connection confirmation request

/Applications/Supremo.app/Contents/MacOS/Supremo -ask-authorization 0|1

To change the duration of “Request user authorization” (default is 30 and maximum is 300 seconds):

/Applications/Supremo.app/Contents/MacOS/Supremo -display-request-for value

To allow authorization after timeout request:

/Applications/Supremo.app/Contents/MacOS/Supremo -allow-after-request-timeout 0|1

Choice of Update Channel

/Applications/Supremo.app/Contents/MacOS/Supremo -update-channel Beta/Stable

Enabling or disabling automatic installation of new versions

/Applications/Supremo.app/Contents/MacOS/Supremo -update-autoinstall off|all

Enabling the password protecting the configuration of Supremo options

echo PASSWORD | /Applications/Supremo.app/Contents/MacOS/Supremo -set-configuration-password

Setting password strength or disabling password

/Applications/Supremo.app/Contents/MacOS/Supremo -password-strength 6|8|10|disabled

Set Allowed IDs

/Applications/Supremo.app/Contents/MacOS/Supremo -set-whitelist 123456789,987654321,012345678,…

Enable feature “Show notes window after each session”

/Applications/Supremo.app/Contents/MacOS/Supremo -show-notes-after-session 0|1

Configuring the Computer Name

/Applications/Supremo.app/Contents/MacOS/Supremo -set-computer-name XXXXXXX

Note: please use strings that consist of 1 to 50 characters. The allowed characters are alphanumeric characters, hyphen, underscore, curly braces, tilde, parentheses, and the special characters “@”, “#”, “$”, “%”, “^”, and “&”.>

Add password

echo PASSWORD | /Applications/Supremo.app/Contents/MacOS/Supremo -add-password

Start a connection from command line sending the 2FA code

/Applications/Supremo.app/Contents/MacOS/Supremo <id> <password> <totp>

Example:

/Applications/Supremo.app/Contents/MacOS/Supremo 234123444 qwerty 563245

 Enable/Disable 2FA

Enable (encoded secret code will be written to STDOUT)

/Applications/Supremo.app/Contents/MacOS/Supremo -enable-2fa

– Disable

/Applications/Supremo.app/Contents/MacOS/Supremo -disable-2fa

Obtaining the Supremo ID via command line

(ID will be written to STDOUT)

/Applications/Supremo.app/Contents/MacOS/Supremo -get-id