Settings
You set up the wall in two places: the settings page and the settings file, companion.ini. The companion watches the file and applies changes without a restart. From version 0.9.8, changing the cast resolution, the camera name or number, or the WebRTC ports restarts MT Cast by itself (before 0.9.8 you restarted the companion).
The status and settings page
Open https://<wall computer>:8730/ in a browser (http:// on a wall set to [web] https=false). With the wall's own certificate, the browser warns once; choose Advanced, then Proceed.
- Status shows what the wall is doing, including the current WebRTC bitrate target.
- Settings (
/settings) edits the settings file below. It has a "Public host name" field forpublic-hostand an Upload button for the card background. Who can open it is explained below.
Settings password
From version 0.9.5, the settings open without a password on the wall PC itself. Open them from the MT Cast tray icon (Open settings..., which opens https://localhost:8730/settings). Anyone at the wall PC has already signed in to it.
Other computers need the network access password. The installer sets none, so at first the settings can only be opened on the wall PC. Another computer then sees "Settings can only be opened on the wall PC until a password for network access is set". The status page shows "Settings from other computers: Off (no network access password)".
To allow other computers:
- On the wall PC, open MT Cast settings from the tray icon.
- Under Network access password, type a password of at least 8 characters twice and choose Set password.
- On the other computer, open
https://<wall computer>:8730/settingsand sign in with that password.
The same section changes or removes the password. A change signs out every other computer. After Remove password, settings open only on the wall PC again.
Note
A wall upgraded from 0.9.4 or earlier keeps the password its installer generated. It is now the network access password. The wall PC no longer asks for it.
Settings file
| System | Location |
|---|---|
| Ubuntu | /etc/mt-screencast/companion.ini |
| Windows | C:\ProgramData\MultiTaction\ScreenCast\companion.ini |
The file uses sections in square brackets. Text after a semicolon on a line is a comment. Unquoted values are taken literally, so Windows paths need no escaping. A value in double quotes decodes \" and \\ only.
[companion]
| Key | Default | Meaning |
|---|---|---|
room-name |
the Canvus installation name, else the computer name | Shown on the card. Also the name visitors see in the AirPlay list. When empty, the wall uses the installation name set in Canvus ([identity] installation-name in Canvus's system settings file, /etc/MultiTaction/canvus/mt-canvus.ini or C:\ProgramData\MultiTaction\canvus\mt-canvus.ini), and picks up changes to it without a restart. Without one, it uses the computer name. The settings page says which one is in use. Names from Canvus longer than 50 bytes are shortened. |
camera-name |
MT Cast |
The camera name in Canvus and Showcase. |
video-number |
40 |
Ubuntu only. MT Cast is /dev/video40. Canvases remember this device, so change it only if another device already uses 40. Not 10, 41-43 or 63. A change restarts MT Cast; open MT Cast in Canvus again afterwards. |
resolution |
1080p |
The cast resolution: 1080p (1920x1080), 1440p (2560x1440) or 4k (3840x2160). From version 0.9.8; see Cast resolution. Before 0.9.8 the file had width and height: a wall with width=1920 and height=1080 (or another of these sizes) keeps that size, and saving the settings writes resolution= instead. |
fps |
30 |
Frame rate. |
audio |
true |
Passes the visitor's sound to the MT Cast input: AirPlay from version 0.9.4, MT Caster and browsers from 0.9.6. false sends the picture only. See Sound. |
audio-delay-ms |
0 |
Delays the sound by this many milliseconds (0 to 1000) when it is ahead of the picture on your wall. A change applies at once. |
[card]
| Key | Meaning |
|---|---|
network-hint |
A line above the instructions, for example Connect to Wi-Fi: Guest-5G. Empty hides it. |
instructions-mac |
Text for Mac users. Empty uses the built-in text. {room} becomes the room name. |
instructions-ios |
Text for iPhone and iPad users. Same rules. |
instructions-extra |
A free line at the bottom, for example a helpdesk number. |
background |
Path to a PNG or JPEG, shown behind the "not licensed" card. The card with the ways to cast fills the whole picture and does not show it. Empty uses the MultiTaction design. The Upload button on the settings page sets this. |
[airplay]
| Key | Default | Meaning |
|---|---|---|
enabled |
true |
Turns AirPlay on or off. |
pin |
random |
random makes a new PIN for each connection. fixed:<4 digits> uses one PIN. none asks for no PIN. |
interface |
all | The network card to advertise and listen on. |
advertise |
when-viewed |
when-viewed advertises the wall only while MT Cast is on a canvas. always advertises all the time. |
[webrtc]
WebRTC carries casts from MT Caster and from browsers.
| Key | Default | Meaning |
|---|---|---|
enabled |
true |
Accepts casts from MT Caster and browsers. |
udp-ports |
50730-50739 |
UDP ports for video. A change restarts MT Cast (before 0.9.8: restart the service). |
max-bitrate-kbps |
6000 |
The most a sender is asked to send at 1080p, from 1000 to 20000. At 1440p the wall asks for 5/3 of it and at 4K for 10/3 (6000 gives 10000 and 20000 kbps). The wall asks for less when it loses packets, and climbs back when the network is clean. A change applies at once, also to a cast in progress. |
[caster]
| Key | Default | Meaning |
|---|---|---|
enabled |
true |
Shows the MT Caster column on the card and announces the room on the network so MT Caster can find it by its join code. Browser share does not depend on it. |
public-download-url |
https://apps.multitaction.com/caster |
A short link to the newest MT Caster file. The card prints it without https://; the QR code and the check use the full address. The wall checks it every 10 minutes (it fetches only the first byte). When the wall can reach it, the card and the join page show only this link. Otherwise they show only the wall's own /get link. See Network and firewall. The 0.9 previews linked to https://apps-preview.multitaction.com/caster; a wall whose file still has that address uses the new default from 26.11. |
The wall leaves MT Caster out when it has no hardware H.264 decoder. See Casting from Windows.
[web]
| Key | Default | Meaning |
|---|---|---|
listen |
lan |
lan lets other computers open the page. localhost limits it to this computer and also hides MT Caster and browser share. |
port |
8730 |
The web port. |
password-hash |
empty | The network access password (other computers only), stored as a salted hash. Set it on the settings page. Empty: settings open only on the wall PC. |
https |
true |
Serves the page over HTTPS on the same port. Browser share needs this. false serves plain HTTP and leaves the browser column off the card. Walls installed before 0.9 keep the value they had. |
cert-file |
empty | Path to a PEM certificate from your IT team. Empty means the wall makes its own. |
key-file |
empty | Path to the PEM private key for cert-file. |
public-host |
empty | The name or IPv4 address that appears on the card, in the QR codes, in the join and download links and in the MT Caster file name. Use the name your certificate is issued for. Empty means the wall's network IPv4 address. |
The card's three options
MT Caster and browser share work out of the box: [webrtc] enabled=true, [web] listen=lan and [web] https=true are the defaults. See Casting from Windows and Casting from a browser.
The card shows up to three columns, numbered in the order shown:
- AirPlay (Mac, iPhone or iPad): the instructions and, while a device pairs, the PIN.
- MT Caster (Windows), when
[caster] enabled=true: the download link, a QR code that downloads MT Caster, and the join code. - Browser (any laptop), when
[web] https=true: the join page address and its own QR code, which opens the join page with the code filled in. Without the MT Caster column, the join code is shown here.
When an option is off, the other columns share the width. The join code never appears on the status page or its preview picture.
Cast resolution
From version 0.9.8 the wall can cast at 1080p (the default), 1440p or 4K. Choose Cast resolution on the settings page, or set [companion] resolution in the settings file. Walls keep 1080p until you change it.
The resolution is the size of the MT Cast input in Canvus and Showcase, and the most a visitor's device is asked to send:
| Resolution | MT Cast input | Asked of MT Caster and browsers |
|---|---|---|
1080p |
1920x1080 | up to 1920x1080, 6000 kbps |
1440p |
2560x1440 | up to 2560x1440, 10000 kbps |
4k |
3840x2160 | up to 3840x2160, 20000 kbps |
A sender with a smaller screen sends its own size; the wall fits it into the picture.
When you change it:
- Saving a new resolution ends a cast in progress and restarts MT Cast. The settings page is away for a few seconds, then shows the status page again.
- In Canvus, open MT Cast again: close the MT Cast input on every canvas, then add it again from the video inputs menu (or restart Canvus). Until then a canvas that kept MT Cast open shows black (Windows) or the old size (Ubuntu).
- On Ubuntu, if MT Cast was still open in Canvus during the change, the status page says "MT Cast runs at 1920x1080 for now". Close MT Cast in Canvus, then choose Apply now on the settings page.
What 4K needs:
- A graphics card that decodes 4K H.264 video (most from 2016 on; NVIDIA, Intel or AMD). If the wall's decoder takes less, the status page says so and the wall asks senders for less.
- For AirPlay above 1080p, a graphics card that also decodes H.265 (HEVC). Macs and iPads send more than 1080 lines only as H.265, and only recent ones (Apple silicon Macs, recent iPads and iPhones) do. AirPlay offers at most 3840x2160. Without H.265 decoding, AirPlay stays at 1920x1080 and the status page says why.
- A wired network for the wall is recommended: 4K casts use up to 20 Mbit/s.
The status page shows the cast resolution and what MT Caster, browsers and AirPlay are asked to send under Cast resolution and Senders are asked for.
HTTPS and certificates
With https=true and empty cert-file and key-file, the wall makes its own self-signed certificate. It covers the computer name, <name>.local and the wall's network addresses. The wall reuses it after a restart and makes a new one when the computer name changes or the certificate is close to expiry.
Visitors see a certificate warning once per browser. They choose "Advanced", then "Proceed" or "Continue". The browser remembers the choice until the wall's certificate changes.
To avoid the warning, ask your IT team for a certificate for the wall's name. Then:
- Set
public-hostto that name. - Set
cert-fileandkey-fileto the PEM certificate and its private key.
If public-host is empty, the card and QR code use the wall's IPv4 address. The certificate must then list that address as a subject alternative name (SAN), because the QR code opens the address, not a name.
The companion watches both files and picks up a renewed pair without a restart.