Configuration file

This section describes how to configure the Canvus client. To do this, you must edit the configuration mt-canvus.ini.

About mt-canvus.ini

There are two versions of mt-canvus.ini on each Canvus client:

• An example version is provided for reference purposes only. It contains all configuration settings currently supported by the Canvus client. When you update the Canvus client, the existing example version is overwritten by a new example version.
• A working version of mt-canvus.ini is used to configure Canvus client operations. The working version is retained if you update Canvus client. After updating, you will need to manually add any new settings to the existing working version of mt-canvus.ini.

Note

When you configure the Canvus client, you must always edit the working version of the configuration file!

See client-config-file for default locations of the configuration file.

Locking client configuration

By default, the Canvus desktop client allows users to make changes to the client configuration file from the settings menu. If this is not desirable, for example on a public video wall installation, the configuration file can be locked to prevent users from making changes to it from the settings menu.

; Prevent Canvus client from making any changes to this configuration file.
; This option is primarily meant for public installations.
; DEFAULT: false
; lock-config=false

Single user or multi-user mode

Canvus client user interface can operate in two different modes optimized for different scenarios. The setting is defined when installing the client, but it can also be adjusted using the setting below.

; Enabling multi-user mode optimizes the application user experience for
; large, multi-user installations. Disable it for a single user experience on
; personal devices like laptops. Available options:
;  true    Multi-user mode is enabled. QR code login is preferred, the user
;          interface is optimized for multiple users.
;  false   Multi-user mode is disabled. All local and network disk drives
;          are shown in the volume list instead of just removable USB drives.
;  auto    The system is considered to be in multi-user mode if the application is
;          shown on more than one display, or if the touch configuration
;          uses MultiTaction displays.
; DEFAULT: auto
; multi-user-mode-enabled=auto

Virtual keyboard

You can configure whether the built-in virtual keyboard in Canvus is enabled or not. By default, the virtual keyboard is enabled in multi-user mode or when running in Windows 10 Tablet mode.

; Should Canvus use a built-in virtual keyboard. Available options:
;  true    Virtual keyboard is opened automatically
;  false   Virtual keyboard is not opened automatically, the system
;          is expected to have a physical keyboard
;  auto    Virtual keyboard is used if multi-user mode is enabled or
;          when Windows 10 Tablet mode is enabled.
; DEFAULT: auto
; virtual-keyboard-enabled=auto

Virtual keyboard layouts

Canvus client supports a limited number of virtual keyboard layouts. You specify enabled layouts which can be switched using a button on the virtual keyboard.

; A comma separated list of enabled virtual keyboard layouts. The first item
; in the list is the default layout. Available choices are:
;   en  (English)
;   fr  (French)
;   ru  (Russian)
; DEFAULT: en
; virtual-keyboard-layouts=en

Tip

You can also change the virtual keyboard layouts from the Canvus client settings menu.

Disks

Canvus allows you to access local disks to get files in or out of your workspace (Windows machines only). These settings are configured under the [system] section of mt-canvus.ini, and the default setting depends on your multi-user-mode setting. In the below example, Windows discs C:, D:, and G: will be accessible from the Canvus menu.

; A comma separated list of drive letters, which should always be displayed on
; the side menu if mounted. A value of '*' means all drive letters. This setting
; is only supported on Windows. The default value depends on the
; multi-user-mode-enabled setting.
; DEFAULT (multi-user-mode-enabled=false): *
; DEFAULT (multi-user-mode-enabled=true): empty
show-volumes=C,D,G 

Email settings

Canvus users can send screen items such as videos and images to an email address. This provides a simple method for exporting screen content out of Canvus.

Provide Canvus client with details about the SMTP server and account credentials that you want to use. You must also specify envelope details for emails sent by Canvus, like the sender account, email subject and so on.

[smtp]
; SMTP configuration that the application uses to send emails.

; SMTP server hostname.
; DEFAULT: empty
; host=

; SMTP server port.
; DEFAULT: empty
; port=

; SMTP username.
; DEFAULT: empty
; username=

; SMTP password.
; DEFAULT: empty
; password=

; Encryption option for email server connection.
; Permitted values: auto, none, SSL, TLS, SSL-ignore-errors
; DEFAULT: auto
; connection-encryption=auto

; Should system proxy settings be ignored while connecting to SMTP.
; DEFAULT: false
; ignore-proxy=false

[mail]
; Email related settings that appear in the email messages that the
; application sends.

; Sender name of the email
; DEFAULT: Canvus
; sender-name=Canvus

; Sender address of the email
; DEFAULT: noreply@multitaction.com
; sender-address=noreply@multitaction.com

; Subject for the emails.
; DEFAULT: Content from Canvus
; subject=Content from Canvus

; Maximum email attachment size in megabytes
; DEFAULT: 32
; max-attachment-size=32

; Default email address when sending email.
; DEFAULT: empty
; default-email-address=

; Allow users to specify another email address when sending email.
; Note: Disabling this setting and setting default-email-address
; to an empty value is not a valid configuration. Canvus will refuse
; to start if you specify it.
; DEFAULT: true
; allow-user-email=true

Fixed workspaces

These workspaces cannot be resized or removed and are defined in the mt-canvas.ini configuration file.

Note

Fixed workspaces are also called \'breakout screens\' or \'control displays\'.

; Fixed workspaces
; Multiple workspaces can be defined that cannot be changed while the
; application is running.
; NOTE: Each workspace is defined with the format [fixed-workspace:<index>],
; where the index (starting at 1) defines the left to right positional order of
; the workspaces.
; [fixed-workspace:1]
; The size setting must be specified for each workspace
; size=3240 1920

; Also, the following settings can be specified for each fixed workspace:

; If specified, this name appears in the workspace label, otherwise the standard
; "Workspace n" naming is used.
; DEFAULT: empty
; name=

; NOTE: setting either view-location or view-scale will override any other
;       settings that influence the initial position and scale of the view, for
;       example, the zoom-viewport and anchor-viewport settings in the [canvas]
;       section.
; The initial location of the view on the workspace. If 0 0, the default
; location will be used.
; NOTE: Values specifying an area outside the view size will be adjusted to
;       ensure the viewport is valid.
; DEFAULT: 0 0
; view-location=0 0

; The initial scale of the view on the workspace. If zero, the default scale
; will be used.
; NOTE: The maximum scale factor value allowed is 10.
; DEFAULT: 0
; view-scale=0

Prefined text snippets

To speed up text entry and avoid typing errors, Canvus supports predefined text (also called keyboard shortcuts or snippets). This feature is designed primarily to streamline demonstrations and presentations.

You often need to type text in Canvus, such as when you add text to a Note widget or run an internet search for a web page. When you use an on-screen keyboard to type, you can insert items of predefined text. This is useful when you need to repeatedly enter the same text string such as a web site URL or email address.

To insert items of predefined text, tap the predefined text button on the on-screen keyboard. Then tap the item you want in the pop-up list of predefined text.

To add predefined text snippets:

1. On the application computer, create a Shortcuts subfolder below the data file folder (see client-data-files).

   For example, if the user logged on while Canvus runs is multi, the expanded paths would be

   • Ubuntu: /home/multi/MultiTaction/canvus-data/data-300/Shortcuts
   • Windows: C:\Users\multi\AppData\Roaming\MultiTaction\canvus-data\data-300\Shortcuts

2. Using your preferred text editor, save one or more files of predefined text in the Shortcuts folder.

   Canvus supports three file formats. You can use any combination of file formats. Choose the combination that best suits the needs of your organization:

   • Single named item: This simple file contains a single item of predefined text. The filename is the name of the predefined text. This name appears in the pop-up list of predefined text. The content of the file is the text you want to insert.

     You can create any number of these files, each containing a separate item of predefined text. However, if you have multiple items of predefined text, you may find the following multiple item file formats easier to maintain.

   • Multiple unnamed items: This file contains multiple items of predefined text. These items do not have names. The filename must start with an underscore character (_).

     Each line in the is a single item of predefined text. Each line appears exactly as written in the pop-up list of predefined text.

   • Multiple named items: This file contains multiple items of predefined text. These items do have names. The filename must have a .json extension and the file content must adhere to JSON syntax.

     Each entry in the file defines an item of predefined text and its name. These names appear in the pop-up list of predefined text. If your items of predefined text are lengthy or similar (such as variants of your corporate URL), you may find that short descriptive item names are easier to recognize in the pop-up list of predefined text items. See the example files in text-snippet-examples.

3. After you create or edit a file of predefined text, you must restart Canvus client to load the new file(s).

Examples

Consider three example files of predefined text (shortcuts) in the Shortcuts folder:

• Example 1: Single item of predefined text

  We recommend you use descriptive filenames. For example, support mail. The file contains a single item of predefined text:

  support@example.com
  

• Example 2: Unnamed items of predefined text

  The filename must begin with an underscore character. For example, _shortcuts. The file contains unnamed items of predefined text:

  Specialists in advanced visualization
  support@example.com
  www.example.com/support-services
  

• Example 3: Named items of predefined text

  The filename must have a .json extension. For example, shortcuts.json. The file contains named items of predefined text:

  [
    {
        "name": "Strapline",
        "text": "Specialists in advanced visualization"
    },
    {
        "name": "Support email",
        "text": "support@unipraxis.com"
    },
    {
        "name": "Support URL",
        "text": "www.unipraxis.com/support-services "
    }
  ]
  

Codice cards

Codice cards refers to fiducial markers for MultiTaction displays. Individual Codice cards can be registered for the following functionality:

• Eraser card - the card will erase annotations on canvas when placed on screen
• Canvas card - the card will open a specific canvas when placed on screen
• Personal folder card - the card will open a specific Codice folder when placed on screen

Codice server

In order to use canvas-cards or client-personal-folder-cards, a codice-server must be specified in the mt-canvus.ini configuration file. eraser-cards are not affected by this setting.

[system]
; Name of the Codice server where all Codice data like the personal folders
; and Canvas Codice maps are stored. To use these features, configure MT
; Canvus multisite server by adding a new section for the server, for
; instance [server:My server], and then setting codice-server=My server
; DEFAULT: empty, which disables all Codice server features
; codice-server=

Note

Use the server name as the value of codice-server. Not the address of the server.

Eraser cards

Canvus users can erase annotations with a pen, mouse or eraser card. An eraser card uses special Codice eraser codes.

By default, Codice cards 612 and 614 are defined as Codice eraser cards, but you can change these codes or add additional eraser codes in the client configuration file. Follow these steps:

1. Edit the following setting in the [annotation] section. (Manually add this section and setting to mt-canvus.ini if they do not already exist.)

   [annotation]
   eraser-marker-codes=612, 614, 615
   

   Where eraser-marker-codes specifies the eraser codes. You can assign a new value or add a comma-separated list of values. In the example above, eraser codes 612, 614 and 615 are all designated as eraser codes.

2. If you have finished editing mt-canvus.ini, restart Canvus on the application computer.

Canvas cards

Canvas cards allow using a Codice card as a shortcut to open a specific canvas. When enabled, users are able to associate specific Codice cards to canvases from the Canvus client user interface (see registering-codice-card).

This feature is disabled by default and must be enabled in the client configuration:

; Allows assignment of Codice marker to be used as a shortcut for canvas
; selection.
; DEFAULT: false
; enable-canvas-codices=false

Codice folder cards

The Canvus client can use a dedicated Canvus server to store Codice folders. This server is referred to as codice-server (see codice-server). Because the Codice folders are stored on a server, they can be accessed from any client using the same codice-server.

This feature requires a dedicated Canvus server and can not be used with a standalone Canvus client.

Codice folders are enabled by default on the client as long as a codice-server has been configured. The Codice folders can be manually disabled by adjusting the following setting in the client configuration file:

[system]
; Enables personal folder -feature that is triggered with Codice markers
; See also server/codice-server setting in this file.
; DEFAULT: true
; enable-personal-folders=true

Set inactivity timeout for workspaces

You can set an inactivity timeout for Canvus client. If users do not interact with a workspace before the timeout expires, the workspace closes and welcome screen appears.

; Timeout (in seconds) after which workspace is closed and returned
; to the welcome screen if the workspace hasn't been interacted with.
; Setting inactive-timeout=0 disables this feature.
; DEFAULT: 14400 (4 hours)
; inactive-timeout=14400

Set inactivity timeout for menus

By default, the canvas menus along the edge or bottom of the screen close automatically after 10 seconds of inactivity. If users do not interact with an open menu before the timeout expires, the menu closes. You can change or cancel the timeout.

; Timeout (in seconds) for expanded menus on the side or bottom of the canvas.
; Set to zero for no timeout.
; DEFAULT: 10
; menu-timeout=10

Configure default pin and display settings

You can configure default pin and display settings for when a canvas opens. For example, you can specify that all canvases are pinned when they open. You can also specify whether to zoom a canvas to achieve a \"best fit\" and jump to an anchor area when a canvas opens.

; Canvas settings
[canvas]

; If true, the canvas is automatically pinned when it is opened.
; DEFAULT: false
; pin-canvas=false

; If true, the canvas is automatically moved to the first anchor position when
; it is opened.
; If there are no anchors or it is false, the zoom-viewport setting is used to
; determine the position.
; DEFAULT: false
; anchor-viewport=false

; If true, the canvas is automatically zoomed to ensure all widgets are visible
; when it is opened.
; If false, the initial position will be determined by the last saved position
; within the session.
; NOTE: If there is no saved position then the viewport will be centralized.
; DEFAULT: false
; zoom-viewport=false

Pin inactive canvases and widgets automatically

Canvases and widgets can be pinned automatically after a period of inactivity. This is useful for users giving a canvas presentation, reducing the risk that they accidentally move or resize screen items.

; If set, an unpinned canvas is pinned after it has not been scaled or moved
; for the specified number of seconds
; If zero, the canvas is never auto-pinned
; DEFAULT: 0
; auto-pin-after=0

; Widget settings
[widget]
; This setting only applies to local canvases. If set, an unpinned widget is
; pinned after it has not been scaled or moved for the specified number of
; seconds
; If zero, the widget is never auto-pinned
; DEFAULT: 0
; auto-pin-after=0

Enable touch mode selector

By default, Canvus supports input devices like pens for annotating and erasing. However, when running on touch screens that do not have pen or eraser support, Canvus offers a third party touch mode which allows users to switch between manipulating content or drawing and erasing using their fingers.

When enabled, a touch selector UI component enables users to quickly switch touch mode using their fingers. The touch selector is permanently visible on the screen and includes three buttons to select what happens when they interact with the software using their fingers:

• Pointer mode: Users can use a finger like a mouse pointer. For example, you can move or resize widgets, tap buttons, and browse web pages or PDF documents.
• Pen mode: Users can use a finger to draw annotations on the screen.
• Eraser mode: Users can use a finger to erase annotations.

[hardware]
; Enable or disable third party touch mode. This mode is meant to be used with
; devices that do not have a separate pen and/or eraser functionality and only
; work with touch input. When enabled, users will see extra UI that allows them
; to use their fingers to annotate and erase.
; DEFAULT: false
; third-party-touch=false

[touch-mode-selector]
; Settings for touch mode selector (only used if third-party-touch is enabled).

; Idle time in seconds before the selector is returned to its home location in
; finger mode.
; DEFAULT: 10
; timeout=10

; Home position of the selector as a percentage of the window width.
; DEFAULT: 90
; home-x-percent=90

; Home position of the selector as a percentage of the window height.
; DEFAULT: 90
; home-y-percent=90

; Distance in pixels from the home position outside which the selector will
; return to the home position.
; DEFAULT: 500
; home-radius=500

Configure Canvus Connect

By default, Canvus client can only display local canvases stored locally on the application computer. You can configure Canvus clients for Canvus Connect, enabling separate Canvus deployments to connect to each other and allowing geographically dispersed users to use shared canvases. For example, users in London and Paris can simultaneously see and work on the same shared canvas.

To configure your Canvus client for Canvus Connect, you must edit settings in mt-canvus.ini. First, you must identify the Canvus server that the client will connect to. Then you must configure the display names for participants in shared canvas sessions. These tasks are described in the following sections.

Tip

You can also use shared_links to add a Canvus Connect server without having to manually edit the Canvus client configuration file.

Verify server setup

Canvus Connect requires a Canvus client in each location plus a Canvus Connect server to manage the connections. Before you can configure your clients, you must set up the server. For details about setting up Canvus Connect server, see server-install.

Specify the server

First, you must identify the Canvus server that your client will connect to.

; Canvus Connect server list
; Configure each server with [server:<name>] section.
; You can have multiple servers, but each server name must be unique.
; [server:Canvus Connect]
;
; The Canvus Connect server host to connect to.
; NOTE: This value must be specified.
; DEFAULT: empty
; server=

; Protocol used for communication with the Canvus Connect server. Options are
; ssl or tcp. The default protocol is determined by the chosen port below.
; DEFAULT (port 443): ssl
; DEFAULT (port 80): tcp
; protocol=ssl

; Port used for communication with the Canvus Connect server. The default port
; is determined by the chosen protocol above.
; DEFAULT (ssl protocol): 443
; DEFAULT (tcp protocol): 80
; port=443

; Control REST API access to this client from this server.
; Valid values are:
;   * none - Do not expose this client to REST API at all.
;   * ro - Allow read-only access to the client state
;   * rw - Allow read-write access to the client state
; DEFAULT: none
; rest-api-access=none

; Set the connection password (if required) for connecting to this server.
; The password cannot contain semicolon, or quotation marks.
; DEFAULT: empty
; connection-password=

About connection passwords

If required, you can set up a connection password for your Canvus server. Only Canvus clients with this password can connect to the server.

This feature provides an additional level of security if you store canvases with sensitive information on your Canvus server and the server is publicly accessible over the internet (ie, clients do not need a VPN to connect to the server).

If a client does not hold the connection password, it cannot connect to the server, even if the other server connection details are correctly specified in the [server:name] section of mt-canvus.ini.

Configure site name for session participants

The site name that appears in the participant dialog is configurable.

[identity]
; Name of the installation of this Canvus client. Is shown in the
; participant list for this client. If empty, the hostname of the machine
; is used.
; DEFAULT: empty
; installation-name=

RDP (Remote Desktop Protocol)

Canvus client has a built-in RDP client. It can be used to connect to an RDP server, for example running on a Windows Server machine. Setting up an RDP connection enables Canvus to do the following:

• Interact with a remote PC using multi-touch gestures
• Interact with applications like Office, Photoshop, Paint, etc. running on the RDP server, thus bringing in more content to the Canvus sessions
• Transfer files to/from the RDP server
• Receive audio and video from the RDP server

Types of RDP Connections

Canvus connects to an RDP server via two different modes:

1. Remote Desktop Mode: This mode typically displays the entire desktop of the RDP server, but it can also be configured to use a RemoteApp connection, which would restrict users from accessing any application other than the one specified. To enable RemoteApp, modify the app parameter in the remote-desktop configuration block of the mt-canvus.ini file. For reviewing the full list of RDP parameters, read client-configure-rdp

; RemoteApp to launch on connect. This setting is used only when connecting
; using the Remote Desktop list.
; NOTE: Backslashes in paths need special handling on Windows computers.
;       Replace each \ with \\.
; Example: %WINDIR%\\System32\\notepad.exe
; Example: ||notepad (using configured RemoteApp alias)
; DEFAULT: empty (show the whole desktop)
; app=

2. Remote File Handler Mode: This mode uses the RemoteApp feature to launch a single application and show windows belonging only to this application. It is possible to define the types of file extensions that should be opened in the RDP widget. To do this, modify the file-extensions parameter in the remote-desktop configuration block of the mt-canvus.ini file. For the full list of RDP parameters, read client-configure-rdp.

file-extensions=doc,docx,ppt,pptx,xls,xlsx,png,mp4,pdf

All the file assets with the specified file extensions will have one extra widget menu button: "Open in remote application". For example, Canvus can modify an image in Photoshop or Paint application running on the RDP server. For this to work seamlessly, you will have to set Photoshop as the default application for images in the RDP server.

Configuring the RDP Server

Canvus can connect to RDP servers running on Windows Server or Windows 10 Professional PCs.

In order to access an RDP Server from Canvus Client, please do the following on the machine running the RDP server:

1. Enable remote desktop feature. Click here for more information

2. Enable support for unlisted remote apps by installing this .reg file. You can also perform the same operation by downloading a RemoteApp Tool, which also allows you to tune the timeout for idle sessions.

Note

Because Canvus is designed to be multi-user software, each RDP widget in Canvus requires its own RDP connection and session. To support more than one simultaneous RDP connection, the RDS server much be configured to allow this.

Tip

If the RDS server is not configured to allow multiple connections and sessions from a single user, your existing RDP connections will be closed in Canvus when you try to open a new one. If you are using a Windows RDS server, open Group Policy Editor. Navigate to Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session host > Connections

• Set the Limit Number of Connections to something more than 1 (or disable it).
• Disable Restrict Remote Desktop Services users to a single Remote Desktop Services session.

When an RDP widget is closed, Canvus disconnects from the RDS server. To ensure disconnected sessions are cleaned up by the RDS server, check the setting under Server Manager. Navigate to your RDS collection properties and set Session > End a disconnected session to a low value.

You must restart the RDS server after modifying these settings.

Configuring the Canvus Client

Define the configuration details about the RDP server in the mt-canvus.ini. It has the following exhaustive list of parameters that allow you to configure RDP connections:

; Remote desktop connection configuration block. There is no limit on the
; number of remote-desktop configuration blocks as long as they all have
; unique names.
; [remote-desktop:Connection name]

; Hostname or IP address of the RDP server with an optional port number.
; If this parameter is empty, the whole configuration block is disabled.
; Examples: localhost, rdp.example.com, 10.0.0.1:1234
; DEFAULT: empty
; hostname=

; Username to use to log in to the server.
; DEFAULT: empty
; username=

; Password for the given username. Leave empty if password is not used
; or if you wish to enter the password manually when connecting.
; DEFAULT: empty
; password=

; Domain to use for authentication.
; DEFAULT: empty
; domain=

; Maximum number of concurrent connections to this server.
; DEFAULT: 0 (unlimited)
; max-connections=0

; Show this server in the Remote Desktop list. If this is set to false, you
; can't directly connect to the server, instead this connection is just used
; to open files.
; Either show-in-server-list must be true or file-extensions must not be empty.
; DEFAULT: true
; show-in-server-list=true

; Comma-separated list of file extensions of files that are opened through
; this server.
; Either show-in-server-list must be true or file-extensions must not be empty.
; Example: doc,docx,ppt,pptx,xls,xlsx
; DEFAULT: empty
; file-extensions=

; RDP gateway hostname with optional port number. Leave empty if gateway
; is not used.
; DEFAULT: empty
; gateway=

; Gateway username.
; DEFAULT: empty
; gateway-username=

; Gateway password.
; DEFAULT: empty
; gateway-password=

; Gateway Domain.
; DEFAULT: empty
; gateway-domain=

; Advanced RDP settings:

; Initial RDP desktop resolution for new RDP widgets.
; DEFAULT: 1920 1080
; desktop-size=1920 1080

; RemoteApp to launch on connect. This setting is used only when connecting
; using the Remote Desktop list.
; NOTE: Backslashes in paths need special handling on Windows computers.
;       Replace each \ with \\.
; Example: %WINDIR%\\System32\\notepad.exe
; Example: ||notepad (using configured RemoteApp alias)
; DEFAULT: empty (show the whole desktop)
; app=

; Command line arguments to RemoteApp, used when "app" setting is used.
; DEFAULT: empty
; app-args=

; Extra FreeRDP command line arguments.
; Example: /drive:home,/home/multi
; DEFAULT: empty
; extra-args=

Below is an example of the parameters required to setup an RDP connection

[remote-desktop:Example RDP Server]
hostname=rdp.example.com
username=some_user
password=some_password
file-extensions=doc,docx,ppt,pptx,xls,xlsx,png,mp4,pdf

Info

• rdp under advanced-content.

Changing keyboard layout

The virtual keyboard that pops up when you want to type something in Canvus can be customized to a desired keyboard layout. The currently supported keyboard layouts are QWERTY and AZERTY.

; Virtual keyboard layout / language. Available choices are:
;   en      (QWERTY)
;   fr      (AZERTY)
; DEFAULT: en
; virtual-keyboard-layout=en

Note

Canvus must be restarted after this setting has been modified.

Cache and asset management

By default, Canvus clients are configured to cache assets used in local and shared canvases. This is done to enhance performance and to reduce the bandwidth usage.

This behavior can be modified if necessary. The maximum time assets are allowed to be cached can be set in the mt-canvus.ini file as defined below:

[cache]
; Maximum time in seconds that assets are allowed to be cached.
; DEFAULT: 2592000 (30 days)
; max-age=2592000

When a local canvas is deleted any unreferenced assets and their caches are deleted from the disk. For shared canvases, Canvus keeps track of every cached asset and when it was last used. If a cached asset has not been used for more than the value specified by max-age, it gets deleted from the disk.

To disable caching set max-age=0 in the mt-canvus.ini file. This means that assets are only cached temporarily and get immediately removed after no longer being needed.

Note

We recommend to keep max-age parameter at its default value to ensure best possible loading performance when opening shared canvases.

Browser settings

You can configure how the built-in web browser in the Canvus client behaves by adjusting the following settings in the configuration file.

[browser]
; Browser start page that is opened when a new web browser widget is created.
; DEFAULT: https://www.google.com
; start-page=https://www.google.com

; Search URL that is opened when a search term is entered in the web browser
; address bar. A word QUERY written in uppercase letters is replaced with the
; search terms.
; DEFAULT: https://www.google.com/search?q=QUERY
; search-url=https://www.google.com/search?q=QUERY

; Specify which internet sites allow content to be uploaded by dragging onto a
; browser widget.
; if upload-sites=* or missing, allow all uploads.
; if upload-sites is empty, prevent all uploads.
; if upload-sites are specified a widget can only be dropped on the browser if
; its current URL contains one of the specified names, e.g.
;   upload-sites=drive.google.com,docs.google.com,mail.google.com
; DEFAULT: *
; upload-sites=*

; Specify if browser sessions should be saved on disk so that cookies,
; browsing history and other session data persists between application
; restarts. Set to false to use in-memory sessions that are cleared when
; application is restarted or user logs out.
; DEFAULT: true
; persistent-sessions=true

; Browsers can handle touches by either passing all touches to the browser
; or converting the first touch to mouse clicks and drags. Different web
; apps work better with the two alternative behaviors. The user can pick
; the best behavior on the browser. This setting determines the default state
; for new browsers. If true, then, by default, touches are converted to mouse
; clicks.
; DEFAULT: false
; mouse-emulation=false

Canvus folder

You can specify a custom folder to be opened from the Canvus folder icon in the finger menu.

; The directory that is opened from the finger menu.
; DEFAULT: Home directory of the active use in single user mode or
;          folder stored inside content/root in multi-user mode.
; canvus-folder=C:\\CanvusFolder

Default canvas

You can specify a default canvas that can be quickly accessed from the welcome screen. The URL can be any shared link to a canvas stored on a Canvus Connect server or a link to a local canvas.

; URL of the default canvas that can be quickly opened from the welcome
; screen.
; DEFAULT: empty
; default-canvas=

Tip

You can also change the default canvas from the Canvus client settings menu.