{ "$id": "http://glue42.com/gd/system.json", "$schema": "http://json-schema.org/draft-06/schema#", "description": "System configuration settings for **io.Connect Desktop**.", "title": "SystemConfig", "type": "object", "properties": { "advancedMode": { "description": "If `true`, will enable additional platform features such as support for UI integration of native apps (Java, .NET), classic groups, non-rectangular window groups, and more. The advanced mode is available only on Windows and is disabled by default. It's recommended to use this mode only if your use case absolutely requires using classic groups or visual integration of native apps (e.g., native apps participating in Workspaces or window groups), because enabling it activates heavy internal logic for processing native app windows which leads to overall performance disadvantages.", "type": "boolean", "default": false }, "uiVersion": { "description": "Version string to be displayed in selected UI elements of **io.Connect Desktop** instead of the default product version. This version is for display purposes only and doesn't have to be a valid semantic version string. It will be used in various UI elements, including the splash screen, the tray menu, the About app, and more. The value defined here will be accessible via the `uiVersion` property of the `iodesktop` object injected in the global `window` object by the io.Connect API (i.e., `iodesktop.uiVersion`).", "type": "string" }, "region": { "description": "**io.Connect Desktop** region.", "type": "string" }, "env": { "description": "**io.Connect Desktop** environment.", "type": "string" }, "systemConfigurations": { "description": "Settings for additional system configuration sources to be used by **io.Connect Desktop**.", "default": { "sources": [ { "type": "path", "source": "./config", "configs": "*", "priority": 1, "required": true } ] }, "$ref": "#/definitions/config" }, "enableGTF": { "description": "Activates the GTF setup.", "type": "boolean", "default": false }, "flash": { "description": "Deprecated. Enables the Flash plugin.", "default": false, "oneOf": [ { "description": "If `true`, the built-in Flash plugin will be enabled.", "type": "boolean", "default": false }, { "description": "URL pointing to the location of a Flash plugin to be used.", "type": "string" } ] }, "server": { "$ref": "#/definitions/serverConfig" }, "commands": { "$ref": "#/definitions/commandsConfig" }, "searchProvider": { "description": "Settings for the built-in search provider of **io.Connect Desktop**.", "type": "object", "properties": { "enabled": { "description": "If `true`, will enable the default search provider of **io.Connect Desktop**.", "type": "boolean", "default": true }, "types": { "description": "Predefined search types for which the provider will return results.", "type": "array", "items": { "description": "Search type for which the provider will return results.", "type": "string" }, "default": [ "application", "layout", "workspace", "swimlane", "action" ], "additionalProperties": false } }, "additionalProperties": false }, "nameLookupService": { "description": "Configuration for the service which is used to retrieve the name of the logged in user.", "type": "object", "properties": { "enabled": { "description": "If `true`, will enable the service for retrieving the name of the logged in user.", "type": "boolean", "default": false }, "url": { "description": "URL pointing to the service for retrieving the name of the logged in user.", "type": "string" }, "name": { "description": "Path to the name values returned by the service (e.g., `{people[0].nameFirst} {people[0].nameLast}`.", "type": "string" } }, "additionalProperties": false }, "auth": { "description": "Authentication settings.", "oneOf": [ { "description": "If `true`, will use the default authentication mechanism. Otherwise, authentication will be disabled and the system username will be used.", "type": "boolean", "default": false }, { "description": "Authentication will be skipped and the specified string will be used as a username. May not work in all environments.", "type": "string" }, { "description": "Configuration settings for SSO, SSPI, Gateway or custom authentication mechanisms.", "$ref": "authController.json" }, { "description": "Credentials that will be used for authentication.", "type": "object", "required": [ "username", "password" ], "properties": { "username": { "description": "Username to be used for authentication.", "type": "string" }, "password": { "description": "Password to be used for authentication.", "type": "string" } }, "additionalProperties": false } ] }, "ssoAuth": { "description": "Settings for SSO authentication.", "$ref": "authController.json" }, "entraSSO": { "description": "Settings for using Microsoft Entra ID authentication. Available only on Windows. If enabled, Windows proof-of-possesion cookies will be automatically injected into requests to the specified Microsoft Entra ID login URLs.", "$ref": "#/definitions/entraSSOConfig" }, "gw": { "description": "Configuration settings for the io.Connect Gateway.", "$ref": "gw.json" }, "channels": { "description": "Settings for the io.Connect Channels.", "type": "object", "default": { "enabled": true }, "properties": { "enabled": { "description": "If `true`, the io.Connect Channels defined here will be available as system Channels to all interop-enabled apps.", "type": "boolean", "default": true }, "definitions": { "description": "Array of Channel definition objects describing the default system Channels. You can define as many Channels as you need.", "type": "array", "default": [], "items": { "$ref": "#/definitions/channelConfig" } } }, "additionalProperties": false }, "windows": { "default": {}, "$ref": "#/definitions/windowsConfig" }, "windowManagement": { "default": {}, "$ref": "#/definitions/windowManagementConfig" }, "appStores": { "description": "Defines local or remote sources of app definitions.", "type": "array", "default": [], "items": { "$ref": "#/definitions/appStoreConfig" }, "additionalProperties": false }, "appStoresCustomError": { "description": "Defines a custom error to be returned when an app store fails to initialize.", "type": "object", "default": { "enabled": false }, "properties": { "enabled": { "description": "If `true`, will enable using the custom error message for app stores.", "type": "boolean" }, "title": { "description": "Title for the custom error message.", "type": "string" }, "body": { "description": "Body for the custom error message.", "type": "string" } }, "additionalProperties": false }, "appStoresTimeout": { "description": "Interval in milliseconds to wait for all required app stores to be initialized.", "type": "number", "default": 120000, "additionalProperties": false }, "autoUpdater": { "description": "Settings for automatically updating **io.Connect Desktop**.", "type": "object", "required": [ "updateSource" ], "properties": { "enabled": { "description": "If `true`, will enable automatically updating **io.Connect Desktop**.", "type": "boolean", "default": false }, "updateSource": { "description": "Settings for the source from which to retrieve the updates.", "oneOf": [ { "description": "Settings for retrieving updates from a static storage.", "type": "object", "required": [ "type", "baseUrl" ], "properties": { "type": { "description": "Type of the update source. Must be set to `\"StaticStorage\"` for static storage updates.", "type": "string", "const": "StaticStorage" }, "baseUrl": { "description": "Base URL pointing to the static storage provider from which to retrieve the **io.Connect Desktop** updates.", "type": "string" } }, "additionalProperties": false }, { "description": "Settings for retrieving updates from a service.", "type": "object", "required": [ "type", "baseUrl" ], "properties": { "type": { "description": "Type of the update source. Must be set to `\"Service\"` for service-based updates.", "type": "string", "const": "Service" }, "baseUrl": { "description": "Base URL pointing to the service from which to retrieve the **io.Connect Desktop** updates. The feed URL has the following shape: `///`.", "type": "string" }, "channel": { "description": "The update channel for the feed URL.", "type": "string" } }, "additionalProperties": false } ] }, "updateIntervalMinutes": { "description": "Interval in minutes at which to check for updates. The minimum allowed interval is 5 minutes.", "type": "number", "minimum": 5, "default": 10 }, "notifyUser": { "description": "If `true`, the user will be prompted to apply the platform update immediately after the update has been downloaded.", "type": "boolean", "default": true }, "ui": { "description": "Settings for the UI prompt displayed to the user after the platform update has been downloaded.", "type": "object", "properties": { "title": { "description": "Title for the dialog.", "type": "string", "default": "Platform Update" }, "text": { "description": "Text for the dialog box.", "type": "string", "default": "A new version is available. Restart the platform to apply the updates." }, "restartButtonText": { "description": "Text for the button for restarting the platform.", "type": "string", "default": "Restart" }, "laterButtonText": { "description": "Text for the button for postponing the platform update.", "type": "string", "default": "Later" } }, "additionalProperties": false } }, "additionalProperties": false }, "otel": { "description": "Settings for OpenTelemetry metrics, traces and logs.", "$ref": "otel.json" }, "metrics": { "description": "Settings for the metrics generated by **io.Connect Desktop**.", "type": "object", "default": { "system": "Glue42", "summaryMetric": { "enabled": true, "collectInterval": 30, "minimalFocusInterval": 1000, "flushOnShutdown": true, "allowExternalApplications": false, "debugLoggingEnabled": false }, "glueInfoMetric": { "enabled": true, "timeout": 300 }, "perfMetric": { "enabled": false } }, "properties": { "system": { "description": "Name for the root metric system.", "type": "string" }, "summaryMetric": { "description": "Settings for the Summary Metrics generated by **io.Connect Desktop**. Summary Metrics provide information about the focus time per app and are generated at regular intervals.", "type": "object", "properties": { "enabled": { "description": "If `true`, will enable Summary Metrics.", "type": "boolean", "default": true }, "collectInterval": { "description": "Interval in minutes at which to publish the gathered metrics. Can't be less than 30 minutes.", "type": "number", "default": 30 }, "minimalFocusInterval": { "description": "The minimal focus time in milliseconds for which to record metric data (e.g., if you want to filter out accidental focus of apps).", "type": "number", "default": 1000 }, "flushOnShutdown": { "description": "If `true`, the gathered metrics will be published on shutdown.", "type": "boolean", "default": true }, "allowExternalApplications": { "description": "If `true`, will allow the collection of focus information from external apps (e.g., Outlook, Excel).", "type": "boolean", "default": false }, "debugLoggingEnabled": { "description": "If `true`, will enable debug logging. For testing purposes only.", "type": "boolean", "default": false } }, "additionalProperties": false }, "glueInfoMetric": { "description": "Provides the platform version and the initialization configuration of the app.", "type": "object", "properties": { "enabled": { "description": "If `true`, will enable the platform info metric.", "type": "boolean", "default": true }, "timeout": { "description": "Interval in seconds to wait for the JavaScript library to initialize. If initialization isn't complete at the end of the specified interval, the metric will be populated with the available values and with `null` values for the rest of the properties.", "type": "number", "default": 300 } }, "additionalProperties": false }, "perfMetric": { "description": "Provides performance information about the platform and the apps.", "type": "object", "properties": { "enabled": { "description": "If `true`, will enable the performance metric.", "type": "boolean", "default": true } }, "additionalProperties": false } }, "additionalProperties": false }, "autoStart": { "description": "Deprecated. Auto start settings for apps.", "type": "object", "default": { "priorityEnabled": true, "highPriorityBatchSize": 3, "highPriorityApplicationTimeout": 1000, "lowPriorityBatchSize": 5, "lowPriorityBatchDelay": 5000 }, "properties": { "priorityEnabled": { "description": "Deprecated. If `true`, apps will be started by priority.", "type": "boolean" }, "highPriorityBatchSize": { "description": "Deprecated. The number of high priority apps that will be started together.", "type": "number" }, "highPriorityApplicationTimeout": { "description": "Deprecated. Interval in milliseconds to wait for each high priority app to start.", "type": "number" }, "lowPriorityBatchSize": { "description": "Deprecated. The number of low priority apps that will be started together.", "type": "number" }, "lowPriorityBatchDelay": { "description": "Deprecated. Interval in milliseconds to wait before starting the next low priority batch of apps.", "type": "number" } }, "additionalProperties": false }, "splash": { "default": {}, "$ref": "#/definitions/splashConfig" }, "about": { "default": {}, "$ref": "#/definitions/aboutConfig" }, "singleApp": { "description": "URL pointing to an app. Using this option will run **io.Connect Desktop** with a single app.", "type": "string" }, "showWindowsInTrayMenu": { "description": "Deprecated. Shows all windows in the system tray menu.", "type": "boolean", "default": true, "additionalProperties": false }, "showAppsInTrayMenu": { "description": "Deprecated. Shows all apps in the system tray menu.", "type": "boolean", "default": true, "additionalProperties": false }, "systemAppStores": { "description": "App stores for critical apps that must be auto started with the platform. System stores aren't monitored for changes.", "type": "array", "items": { "$ref": "#/definitions/appStoreConfig" }, "additionalProperties": false }, "nodePath": { "description": "The path to the Node.js environment that **io.Connect Desktop** will use to run Node.js apps. By default, the Node.js version bundled with **io.Connect Desktop** will be used.", "type": "string" }, "emailClient": { "description": "Settings for the email client to use when sending emails via API or when submitting feedback.", "type": "object", "additionalProperties": false, "default": { "type": "Outlook" }, "properties": { "type": { "description": "Defines the type of the email client.", "type": "string", "enum": [ "Outlook", "MAPI", "SMTP" ], "default": "Outlook" }, "config": { "description": "Configuration for the email client.", "type": "object", "oneOf": [ { "description": "Configuration for the SMTP email client.", "type": "object", "additionalProperties": false, "properties": { "host": { "description": "The name or IP address of the host used for SMTP transactions.", "type": "string" }, "port": { "description": "The port used for SMTP transactions.", "type": "number" }, "user": { "description": "The username used for authentication.", "type": "string" }, "password": { "description": "The password used for authentication.", "type": "string" }, "from": { "description": "The email address of the sender.", "type": "string" }, "enableSSL": { "description": "If `true`, the SMTP email client will use SSL to encrypt the connection.", "type": "boolean" } } } ] } } }, "issueReporting": { "description": "Settings for sending feedback from **io.Connect Desktop**.", "type": "object", "default": { "attachmentsViewMode": "file", "mail": { "enabled": false }, "jira": { "enabled": false }, "folderAttachments": [] }, "properties": { "enabled": { "description": "If `true`, the Feedback Form will be enabled in **io.Connect Desktop**. Set to `false` to disable it. When disabled, the Feedback Form won't be displayed automatically in case of platform crashes and the users won't be able to access it from the platform tray menu or from the \"Feedback\" button of your interop-enabled apps.", "type": "boolean", "default": true }, "attachScreenshots": { "description": "If `true`, will attach screenshots of all monitors to the issue report.", "type": "boolean" }, "attachmentsViewMode": { "description": "Defines how the attachments will be displayed in the Feedback Form. Possible values are `\"file\"` or `\"category\"`. If set to `\"file\"`, all attachable files will be displayed as separate items, otherwise several main categories will be displayed and if the category is selected by the user, all files in it will be attached.", "type": "string", "enum": [ "file", "category" ], "default": "file" }, "jira": { "description": "Jira configuration.", "type": "object", "properties": { "enabled": { "description": "If `true`, will enable the option to create a Jira ticket when submitting the issue.", "type": "boolean", "default": "false" }, "url": { "description": "Link to the Jira API.", "type": "string" }, "user": { "description": "The username of the user who will create the ticket.", "type": "string" }, "password": { "description": "The password of the user who will create the ticket.", "type": "string" }, "project": { "description": "The name of the project in which the ticket will be created.", "type": "string" }, "preferredRole": { "description": "Preferred role in the Jira project.", "type": "string" }, "preferredRoleDescriptor": { "description": "Description of the preferred role in the Jira project.", "type": "string" }, "useProjectLeadAsPreferredAssignee": { "description": "If `true`, will assign the ticket to the project lead.", "type": "boolean" }, "tlsVersion": { "description": "Force TLS protocol version, e.g. `\"TLS1.2\"`.", "type": "string" }, "noPriority": { "description": "If `true`, the ticket \"Priority\" field won't be set.", "type": "boolean" }, "noEnvironment": { "description": "If `true`, the ticket \"Environment\" field won't be set.", "type": "boolean" } }, "additionalProperties": false }, "mail": { "description": "Email configuration.", "type": "object", "properties": { "enabled": { "description": "If `true`, will enable the option to send an email when submitting the issue.", "type": "boolean", "default": "false" }, "action": { "description": "Defines the action to be performed when submitting the Feedback Form. Possible values are `\"send\"` or `\"display\"`. If set to `\"send\"`, the email will be sent immediately (if possible, depending on security settings). If set to `\"display\"`, an email draft will be shown to be reviewed and sent manually by the user. Valid only for Outlook and MAPI email clients.", "type": "string", "enum": [ "send", "display" ], "default": "send" }, "zipAttachments": { "description": "If `true`, the attachments will be archived.", "type": "boolean" }, "bugSubjectPrefix": { "description": "Prefix for the email subject when the issue is a bug.", "type": "string" }, "reportSubjectPrefix": { "description": "Prefix for the email subject when sending feedback.", "type": "string" }, "recipients": { "description": "List of email addresses to which the issue report will be sent.", "type": "array", "items": { "type": "string", "description": "Single email address." } }, "allowEditRecipients": { "description": "If `true`, the user will be allowed to manually add more recipients.", "type": "boolean" }, "maxAttachmentMB": { "description": "The maximum size of the attachments in MB.", "type": "string" } }, "additionalProperties": false }, "folderAttachments": { "description": "Attachments configuration.", "type": "array", "items": { "description": "Describes an attachment.", "type": "object", "properties": { "name": { "description": "Name for the attachment.", "type": "string" }, "folderPath": { "description": "Path to the folder that will be attached.", "type": "string" }, "zipFolderPath": { "description": "Path in the archived folder.", "type": "string" }, "filter": { "description": "Regex filter that will be applied to each file in the folder - e.g., `\"*.log\"`.", "type": "string" }, "category": { "description": "Category for the attached item.", "type": "string", "default": "Logs" }, "selected": { "description": "If `true`, the category (or all files under this category) in the Feedback Form will be selected by default.", "type": "boolean", "default": true }, "recursive": { "description": "If `true`, will collect and attach all files from all folders located inside the specified folder. Set to `false` to collect the files only in the specified folder.", "type": "boolean", "default": true } }, "required": [ "name", "folderPath", "zipFolderPath", "filter", "category" ], "additionalProperties": false }, "additionalProperties": false }, "appVersion": { "description": "Deprecated. Set automatically from the `\"version\"` top-level property.", "type": "string" }, "buildVersion": { "description": "Deprecated. Set automatically from the `\"build\"` top-level property.", "type": "string" }, "environment": { "description": "Deprecated. Set automatically from the `\"env\"` top-level property.", "type": "string" }, "region": { "description": "Deprecated. Set automatically from the `\"region\"` top-level property.", "type": "string" }, "form": { "description": "Object that can be used to specify various properties for the io.Connect Window containing the Feedback Form, or to provide a URL pointing to a custom Feedback app.", "type": "object", "default": { "showEnvironment": false }, "properties": { "width": { "description": "Width in pixels for the Feedback Form.", "type": "number" }, "height": { "description": "Height in pixels for the Feedback Form.", "type": "number" }, "url": { "description": "URL pointing to the location of the Feedback app.", "type": "string" }, "transparent": { "description": "If `true`, the io.Connect Window containing the Feedback Form will have a transparent background.", "type": "boolean" }, "showEnvironmentInfo": { "description": "If `true`, the Feedback Form will show a field with details about the io.Connect environment.", "type": "boolean", "default": false } }, "additionalProperties": true } }, "additionalProperties": false }, "crashReporter": { "description": "Settings for reporting crashes.", "type": "object", "default": { "enabled": true, "folderPath": "%IO_CD_USER_DATA_DIR%/crashes", "companyName": "Interop Inc", "productName": "io.Connect Desktop", "output": { "type": "local" } }, "properties": { "enabled": { "description": "If `true`, the crash reporter will be enabled.", "type": "boolean" }, "folderPath": { "description": "Location for the crash reporter logging and memory dumps when the output type is set to `\"local\"`.", "type": "string" }, "companyName": { "description": "The company name to be included in the crash report.", "type": "string" }, "productName": { "description": "The product name to be included in the crash report.", "type": "string" }, "output": { "description": "Output settings for the crash reporter.", "type": "object", "properties": { "type": { "description": "Type of the crash reporter output. Crash reports can be saved locally, sent to a REST service, or to a Backtrace server.", "type": "string", "enum": [ "local", "server", "backtrace" ] }, "serverUrl": { "description": "URL pointing to the server that will receive the crash report if the output type is set to `\"server\"`.", "type": "string" }, "backTraceConfig": { "description": "Settings for the Backtrace client.", "type": "object", "properties": { "token": { "description": "Unique token for sending data to Backtrace.", "type": "string" }, "url": { "description": "URL pointing to the Backtrace server.", "type": "string" }, "handleMainExceptions": { "description": "Enables sending unhandled errors in the main process to Backtrace. Set to `\"all\"` to send both uncaught exceptions and unhandled `Promise` rejections. Set to `\"only-errors\"` to send only uncaught exceptions.", "type": "string", "enum": [ "all", "only-errors" ] } }, "additionalProperties": false, "required": [ "token", "url" ] }, "dumps": { "description": "Settings for handling the dump files for crash reports.", "type": "object", "properties": { "limit": { "description": "Limit for the number of dump files to keep. When a new dump file is created, the oldest one will be deleted to conform with the file limit.", "type": "number" }, "deleteOnSent": { "description": "If `true`, when a dump file is sent, it will be deleted instead of moved to the `/sent` folder.", "type": "boolean" } } } }, "if": { "properties": { "type": { "enum": [ "server" ] } } }, "then": { "required": [ "serverUrl" ] }, "additionalProperties": false }, "ignoreSystemCrashHandler": { "description": "If `true`, crashes generated in the main process won't be forwarded to the system crash handler.", "type": "boolean", "default": false } }, "required": [ "companyName", "productName", "folderPath", "enabled", "output" ], "additionalProperties": false }, "useEmbeddedShell": { "description": "If `true`, will use the embedded shell app.", "type": "boolean", "default": true }, "registerHtmlContainer": { "description": "If `true`, will inject the `htmlContainer` object. It will be used for legacy apps.", "type": "boolean", "default": false }, "windowAvailableOnURLChanged": { "description": "Deprecated. If `true`, will return the `window` object via the `onUrlChanged()` method.", "type": "boolean" }, "shutdownOnEmptyAppList": { "description": "If `true`, will show a dialog to the user when no apps are available (including a shell app). Closing the dialog will shutdown **io.Connect Desktop**. Otherwise, the platform will continue running even if no apps are available.", "type": "boolean", "default": true }, "closeRunningInstancesOnAppRemoved": { "description": "If `true`, all running app instances will be closed when the app definition is disabled or removed.", "type": "boolean", "default": false }, "licREST": { "description": "URL pointing to a service for validating the license.", "type": "string" }, "activityColors": { "description": "Deprecated. Colors that will be used for the borders of activities.", "type": "array", "items": { "type": "string" }, "default": [ "#4b5d60", "#394e78", "#31758c", "#318c71", "#657839" ] }, "hotkeys": { "description": "Settings for registering and using hotkeys in **io.Connect Desktop**.", "default": true, "oneOf": [ { "description": "If `true`, hotkeys will be enabled.", "type": "boolean" }, { "$ref": "#/definitions/hotkeys" } ] }, "swimlane": { "$ref": "#/definitions/swimlaneConfig" }, "extensions": { "description": "List of Chrome extensions to be added.", "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "allowFileAccess": { "description": "If `true`, will allow extensions to access the file system.", "type": "boolean", "default": false }, "path": { "description": "Path to the extension.", "type": "string" } }, "required": [ "path" ] }, { "description": "Path to the extension.", "type": "string" } ] } }, "devToolsExtensions": { "description": "List of Chrome DevTools extensions to be added.", "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "allowFileAccess": { "description": "If `true`, will allow extensions to access the file system.", "type": "boolean", "default": false }, "path": { "description": "Path to the extension.", "type": "string" } }, "required": [ "path" ] }, { "description": "Path to the extension.", "type": "string" } ] } }, "layouts": { "default": {}, "$ref": "#/definitions/layoutsConfig" }, "themes": { "description": "Settings for the io.Connect themes.", "type": "object", "default": { "syncWithDefaultOSAppMode": false, "setThemesMethodName": "T42.Themes.Change", "getThemesMethodName": "T42.Themes.Get", "toggleThemesMethodName": "T42.Themes.Toggle", "sharedContextName": "T42.Themes", "availableThemes": [] }, "properties": { "availableThemes": { "description": "List of objects describing the available platform themes.", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "Unique name for the theme. Will be used as a CSS class selector applied to the `` element of the web app.", "type": "string" }, "displayName": { "description": "Display name for the theme.", "type": "string" }, "description": { "description": "Optional description for the theme.", "type": "string" }, "background": { "description": "Background color for the theme in hex format (e.g., `\"#FFFFFF\"`).", "type": "string" }, "groupIcon": { "description": "The name of an icon file that will be used in the Windows taskbar for io.Connect Window groups. The file must be in ICO format and must be located in the `/assets/images` folder.", "type": "string" }, "groupIconURL": { "description": "If you have the same icon for some or all apps and want to group them with window groups in the Windows taskbar, you should provide the URL of this icon as specified in the app definitions. This icon won't be downloaded - the icon URL specified here will be used only for creating an icon ID that the OS needs for grouping icons in the Windows taskbar.", "type": "string" }, "tabGroupIcon": { "description": "The name of an icon file that will be used in the Windows taskbar for io.Connect Window tab groups. The file must be in ICO format and must be located in the `/assets/images` folder.", "type": "string" }, "loadingAnimation": { "description": "Path to a loading animation in XAML format to be used by the platform for io.Connect Windows when using classic groups. This must be a local file. The path can be absolute or relative and you can use environment variables.", "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, "default": [ { "name": "dark", "displayName": "Dark", "description": "Dark theme for the io.Connect platform." }, { "name": "light", "displayName": "Light", "description": "Light theme for the io.Connect platform." } ] }, "syncWithDefaultOSAppMode": { "description": "If `true`, will synchronize the io.Connect theme with the default OS app mode.", "type": "boolean", "default": false }, "setThemesMethodName": { "description": "The name of the registered Interop method for changing the themes.", "type": "string", "default": "T42.Themes.Change" }, "getThemesMethodName": { "description": "The name of the registered Interop method for retrieving the themes.", "type": "string", "default": "T42.Themes.Get" }, "toggleThemesMethodName": { "description": "The name of the registered Interop method for toggling the themes.", "type": "string", "default": "T42.Themes.Toggle" }, "sharedContextName": { "description": "Name of the shared context object for the themes.", "type": "string", "default": "T42.Themes" }, "convertThemesConfigToCSS": { "description": "If `true`, the theme settings for the io.Connect classic groups defined in the `themes.json` file will be converted to CSS variables and injected in the Web Group App. Set to `true` if you are using classic groups instead of web groups and want to automatically migrate your custom theme styles to the Web Group App. This is necessary, because, as of **io.Connect Desktop** 10.0, web groups are the default mechanism for handling io.Connect windows in the default platform mode.", "type": "boolean", "default": false } }, "additionalProperties": false }, "applications": { "default": {}, "$ref": "#/definitions/applicationsConfig" }, "citrix": { "default": {}, "$ref": "#/definitions/citrixConfig" }, "folders": { "default": {}, "$ref": "#/definitions/foldersConfig" }, "envVars": { "description": "Settings for defining environment variables that will be set when **io.Connect Desktop** starts. Environment variables can be defined both in local and in remote system configuration sources. The variables specified in the configuration source with the highest priority will override the values of the variables with the same names in all other lower priority configuration files.", "type": "object", "properties": { "set": { "description": "Environment variables in the form of key/value pairs that will be set on platform startup. Values can contain references to other environment variables by using the `%VAR_NAME%` format. To clear the value of an environment variable, set it to an empty string.", "type": "object", "additionalProperties": { "type": [ "string", "number", "boolean" ] } } }, "additionalProperties": false }, "build": { "description": "Allows replacing the default product name with a custom one. Visible in different UI components such as the splash screen and the \"About\" app.", "type": "string", "default": "io.Connect Desktop" }, "legacy": { "default": {}, "$ref": "#/definitions/legacyConfig" }, "proxy": { "description": "Settings for the Electron proxy configuration. For more details about the available settings and example usage, see the [`ProxyConfig`](https://www.electronjs.org/docs/latest/api/structures/proxy-config) object definition in the Electron documentation.", "type": "object", "properties": { "mode": { "description": "Proxy mode.", "type": "string", "enum": [ "direct", "auto_detect", "pac_script", "fixed_servers", "system" ] }, "pacScript": { "description": "URL pointing to a proxy auto-configuration script (PAC).", "type": "string" }, "proxyRules": { "description": "Rules indicating which proxies to use.", "type": "string" }, "proxyBypassRules": { "description": "Rules indicating which URLs should bypass the proxy settings.", "type": "string" }, "legacy": { "description": "Deprecated. Legacy io.Connect proxy settings.", "type": "object", "properties": { "useSystemSettings": { "description": "If `true`, will use the OS proxy settings.", "type": "boolean" }, "pacScript": { "description": "URL pointing to a proxy auto-configuration script (PAC).", "type": "string" }, "url": { "description": "Proxy URL to use.", "type": "string" }, "rules": { "description": "Semicolon-delimited list of proxy rules. For syntax, see the Electron [Set Proxy Config](https://www.electronjs.org/docs/latest/api/session#sessetproxyconfig) documentation.", "type": "string" }, "bypassRules": { "description": "Semicolon-delimited list of host patterns that will always use direct connection. For syntax, see the Electron [Set Proxy Config](https://www.electronjs.org/docs/latest/api/session#sessetproxyconfig) documentation.", "type": "string" }, "autodetectTimeoutMs": { "description": "Interval in milliseconds to wait for response when attempting to detect a PAC script.", "type": "number" } } } } }, "extends": { "description": "Deprecated. List of objects defining local or remote locations of system configuration files that will be extended by the current configuration in this file.", "type": "array", "items": { "$ref": "#/definitions/extendsConfig" } }, "extendedBy": { "description": "Deprecated. List of objects defining local or remote locations of system configuration files that will extend the current configuration in this file.", "type": "array", "items": { "$ref": "#/definitions/extendsConfig" } }, "tray": { "default": {}, "$ref": "#/definitions/trayConfig" }, "allowMultipleInstances": { "description": "Specifies whether to completely disable running multiple instances of **io.Connect Desktop**, or to allow it only if they are running in different environments and regions.", "type": "string", "default": "inDifferentEnvRegion", "enum": [ "never", "inDifferentEnvRegion" ] }, "perfCollector": { "description": "Settings for the internal performance data collector.", "type": "object", "properties": { "intervalSec": { "description": "Interval in seconds for publishing performance data.", "type": "number" }, "eventDelaySec": { "description": "In case of specific events (app started or stopped) performance data will be published outside of the publishing interval. This setting defines an interval in seconds to wait before publishing the data after the event. If another event occurs during the delay window, the initial publishing is canceled and a new one is scheduled after the specified delay interval.", "type": "number" }, "memory": { "description": "If `true`, will collect memory data.", "type": "boolean", "default": true }, "cpu": { "description": "If `true`, will collect CPU data.", "type": "boolean", "default": true } }, "additionalProperties": false }, "performanceTracker": { "description": "Deprecated. Settings for the internal performance tracker.", "type": "object", "default": {}, "properties": { "enable": { "description": "If `true`, will enable tracking apps in the Application Monitor.", "type": "boolean", "default": false }, "trackAutoStarted": { "description": "If `true`, will track the performance of auto started io.Connect apps.", "type": "boolean", "default": false }, "isTrackingEnabled": { "description": "If `true`, will enable gathering and sending app performance information to the Performance Report.", "type": "boolean", "default": false } }, "additionalProperties": false }, "protocolHandler": { "description": "Settings for the default and any custom protocol handlers in **io.Connect Desktop**.", "default": {}, "anyOf": [ { "$ref": "#/definitions/protocolHandlerConfig" }, { "description": "List of configuration objects for multiple protocol handlers.", "type": "array", "items": { "$ref": "#/definitions/protocolHandlerConfig" } } ] }, "alreadyRunningAction": { "description": "Defines the behavior when an **io.Connect Desktop** instance is already running and the user tries to start another one in the same environment and region. You can choose to show a dialog to the user, to make the platform exit silently, or to focus the already running instance.", "type": "string", "default": "focus", "enum": [ "alert", "silent", "focus" ] }, "applicationPreferences": { "description": "Settings for the preferences stored by using the App Preferences API.", "type": "object", "properties": { "store": { "$ref": "#/definitions/applicationPreferencesStore" } } }, "allowNTLMCredentialsForDomains": { "description": "Dynamically sets whether to always send credentials for NTLM over HTTP or Negotiate authentication. Accepts a comma-separated list of servers with enabled integrated authentication.", "type": "string" }, "reloadIFrames": { "description": "Reloads an `