Settings

external interface Settings(source)

Properties

Link copied to clipboard
abstract var args: ReadonlyArray<String>?

The command-line arguments to pass to the executable. Defaults to an empty array. Take care to wrap paths in quotes.

Link copied to clipboard
abstract var enabled: Boolean?

true will change the startup approved registry key and enable / disable the App in Task Manager and Windows Settings. Defaults to true.

Link copied to clipboard
abstract var name: String?

value name to write into registry. Defaults to the app's AppUserModelId().

Link copied to clipboard
abstract var openAsHidden: Boolean?

true to open the app as hidden. Defaults to false. The user can edit this setting from the System Preferences so app.getLoginItemSettings().wasOpenedAsHidden should be checked when the app is opened to know the current value. This setting is not available on MAS build s or on macOS 13 and up.

Link copied to clipboard
abstract var openAtLogin: Boolean?

true to open the app at login, false to remove the app as a login item. Defaults to false.

Link copied to clipboard
abstract var path: String?

The executable to launch at login. Defaults to process.execPath.

Link copied to clipboard
abstract var serviceName: String?

The name of the service. Required if type is non-default. Only available on macOS 13 and up.

Link copied to clipboard
abstract var type: SettingsType?

The type of service to add as a login item. Defaults to mainAppService. Only available on macOS 13 and up.