Skip to content

Settings Page

New in Canvus client 26.4.0, the in-app Settings page provides a graphical interface for configuring Canvus client settings. Settings are grouped into collapsible sections, each one corresponding to a section of the mt-canvus.ini configuration file, so you can find and change options without editing the file in a text editor.

The Settings page does not replace mt-canvus.ini — it edits the working copy of that file on disk. Changes you save in the Settings page are written straight back to mt-canvus.ini, and any manual edits to the INI file are picked up the next time the Settings page is opened. Advanced settings that are not exposed in the Settings page can still be configured by editing mt-canvus.ini directly.

Note

Settings changed via the Settings page are saved to the mt-canvus.ini configuration file. For the full list of available settings and their INI file equivalents, see Configuration file.

Opening the Settings Page

  1. Open the Canvus settings menu.
  2. Select Settings.

Screenshot to add: settings-page-01.png

Show: The Canvus settings menu open, with the Settings option highlighted.

The Canvus settings menu with the Settings option visible
Select Settings from the settings menu to open the configuration page.

The Settings page opens, showing all available configuration sections.

Screenshot to add: settings-page-02.png

Show: The Settings page open, showing several collapsible section headers (e.g., Identity, Email, System, Canvas) in their collapsed state.

The Settings page showing collapsed configuration sections
The Settings page groups related settings into collapsible sections.

Tap any section header to expand it and reveal the settings inside. Tap the header again to collapse it.

Settings are organised into nine numbered groups that mirror the comment blocks in mt-canvus.ini. Groups 2 and 7 are admin-only — see Admin-Locked Settings below.

Group 1 — Identify this machine

  • Identity — Installation name for this Canvus client instance (installation-name).

Group 2 — Collaboration & multi-site (admin-only)

This group is managed outside the INI file. On installations where Canvus Connect servers, fixed workspaces, or other multi-site options are configured, these settings can only be changed by an administrator. The Settings page displays a Contact your administrator notice instead of editable fields.

Group 3 — Core system & storage

  • System — Multi-user mode, virtual keyboard, inactive timeout, canvas codices, file and task limits, lock-config, and other core system settings.
  • Content — Content root folder path (root). Requires restart.
  • Cache — Cache maximum age (max-age).
  • Backup — Backup root folder path (root). Requires restart.

Group 4 — Email out

  • Email (SMTP) — Outbound mail server: host, port, username, password, connection encryption, ignore-proxy. All settings require restart.
  • Email (Content) — Sender name, sender address, email subject, maximum attachment size, default email address, allow-user-email.

Group 5 — UI defaults

  • Welcome Screen — Whether users can exit Canvus from the welcome screen (allow-exit).
  • Canvas — Default canvas behaviour: canvas size, pin-canvas, anchor-viewport, zoom-viewport, auto-pin-after, custom menu file.
  • Widget — Default widget behaviour: auto-pin-after, activation gestures.
  • Web Browser — Embedded browser start page, search URL, upload sites, persistent sessions, mouse emulation.
  • Annotation — Eraser marker codes and eraser size.
  • Password Security — Password policy: minimum length, lowercase, uppercase, numeric and symbol counts, maximum repeats and sequence length.

Group 6 — Media widgets

  • PDF — PDF raster resolution.
  • Video — Tap-to-play, screenshare audio.
  • Video Stream — IP camera / video stream settings: min/max FPS, min/max resolution, prefer-uncompressed.
  • Image Search — Google Custom Search API key and engine ID.

Group 7 — Display & rendering (admin-only)

This group is managed outside the INI file. Display and rendering settings (fixed workspace geometry, output mapping, and related options) can only be changed by an administrator. The Settings page displays a Contact your administrator notice instead of editable fields.

Group 8 — Input hardware

  • Remote Touch — Remote touch interface, port, and server IP. All settings require restart.
  • Hardware — Third-party touch device support (third-party-touch). Requires restart.
  • Touch Mode Selector — Timeout, home position (x/y percent and radius).

Group 9 — External integrations

  • Local Share — Shared folder path and share name.
  • Remote Mount — Daemon port (requires restart), mount options, mount folder (requires restart), log messages.
  • Auxiliary PC — Host, port, primary/secondary/aux display settings, username, password, remote source, desktop mode extensions, log messages, Canvus mapped drive, and remote touch settings.

Editing Settings

  1. Expand a section by tapping its header.
  2. Locate the setting you want to change.
  3. Edit the value using the provided control.

Each setting uses a control appropriate for its type:

  • Toggle — boolean settings (for example, pin-canvas or mouse-emulation). On/off.
  • Number field — integer settings (timeouts in seconds, port numbers, size limits).
  • Text field — short strings such as a sender name, email subject, or hostname.
  • File / folder picker — path-valued settings such as the content root or backup folder.
  • List editor — comma-separated values such as virtual-keyboard-layouts or show-volumes.
  • Password field — credential fields such as the SMTP password or RDP password. The value is masked on screen and stored in the INI file in the existing format.
  • Dropdown — settings with a fixed set of allowed values (for example, auto / true / false, or SMTP connection-encryption).

Settings that cannot take effect until Canvus client is restarted are marked with a Restart required indicator in the Settings page. After you save such a setting, Canvus prompts you to restart the client. Until you do, the setting is written to mt-canvus.ini but the running session continues to use the previous value.

Screenshot to add: settings-page-03.png

Show: A settings section expanded (e.g., Identity or Email), with several settings visible and one being edited (e.g., a text field with a cursor).

An expanded settings section showing editable fields
Expand a section to reveal its settings. Each setting uses an appropriate input control for its type.

Saving Changes

When you have made your changes, tap Save to write them to the configuration file.

  • If any changed settings require a restart to take effect, Canvus will prompt you to restart.
  • Tap Cancel at any time to discard all unsaved changes.

Screenshot to add: settings-page-04.png

Show: The Save and Cancel buttons visible at the bottom of the Settings page, with a restart prompt dialog visible above them.

The Settings page Save and Cancel buttons, with a restart prompt dialog
After saving, Canvus prompts for a restart if any changed settings require it.

Admin-Locked Settings

Two groups in the Settings page are reserved for administrators:

  • Group 2 — Collaboration & multi-site — Canvus Connect servers, fixed workspaces, and other multi-site deployment options.
  • Group 7 — Display & rendering — Output mapping, fixed workspace geometry, and related display configuration.

These groups are managed outside mt-canvus.ini and are not exposed as editable fields. The Settings page displays a Contact your administrator notice in place of controls.

On a managed installation (for example, a video-wall deployment where lock-config has been set to true), the entire Settings page is replaced by a locked-configuration message and no settings can be modified through the UI. Settings must be changed by an administrator with direct access to mt-canvus.ini.