Skip to content

Installing on Linux

MT Screencast runs on Ubuntu 24.04 as a Debian package.

Install

  1. Download the .deb from the downloads page.
  2. Install it:

    sudo apt install ./mt-screencast_<version>_amd64.deb
    

The package installs and starts the mt-screencast service. It also:

  • creates the system user mt-screencast, a member of the group video;
  • creates /etc/mt-screencast/companion.ini from the default settings, only if the file is missing, so upgrades keep your edits;
  • creates the data folder /var/lib/mt-screencast/ for the uploaded background and the TLS certificate;
  • loads the v4l2loopback kernel module at boot and lets the group video use /dev/v4l2loopback;
  • includes a copy of MT Caster, which the wall offers visitors when it cannot reach the MT Caster download on apps.multitaction.com;
  • from version 0.9.4, installs the user service mt-cast-audio for every desktop user and starts it in sessions that are already open. It gives Canvus the cast's sound as the source MT Cast. It needs pactl and pacat (package pulseaudio-utils), which the package pulls in. From version 0.9.6 it also adds an output named MT Cast relay (internal) that carries the sound to that source. It is not a speaker: leave it alone and do not choose it as the computer's sound output.

The package never changes other programs' virtual cameras. OBS Studio's virtual camera, for example, keeps its own device.

Settings password

From version 0.9.5 the package sets no password. On the wall PC, open MT Cast settings from the tray icon: no password is needed there. To open the settings from other computers, set a network access password on the settings page first. See Settings password.

Check the service

systemctl status mt-screencast
journalctl -u mt-screencast

When the service runs, MT Cast appears in the video inputs of Canvus and Showcase.

For the sound, as the desktop user:

systemctl --user status mt-cast-audio
pactl list sources short

The list must contain mt_cast_1.

Secure Boot

With Secure Boot on, the kernel loads only signed modules.

  • Ubuntu's prebuilt linux-modules-v4l2loopback-* packages are signed. They need nothing from you.
  • A module that v4l2loopback-dkms builds on the wall computer is signed with the computer's own key. You must enrol that key once at the console. At the next restart, the blue MokManager screen asks you to choose "Enroll MOK" and enter the password you set during the install.

To check, run:

mokutil --sb-state
modinfo -F signer v4l2loopback

If the module cannot load, the service logs cannot open /dev/v4l2loopback and retries.

Upgrade, remove and purge

  • Upgrade. Install the new .deb the same way. Your settings stay.
  • Upgrading from 0.9.0 or 0.9.1. From 0.9.2, MT Cast is always /dev/video40 (earlier versions took the first free number, often /dev/video0). Place the MT Cast input on each canvas again once. If Canvus has the old device open during the upgrade, the move happens at the next restart; the companion's status page says so. If another device already uses /dev/video40, MT Cast takes a free number and the status page shows a warning. See video-number in Settings.
  • Remove. sudo apt remove mt-screencast stops the service and removes the program. The MT Cast camera goes away. Your settings stay.
  • Purge. sudo apt purge mt-screencast also removes /etc/mt-screencast, /var/lib/mt-screencast and the password file.

Ports

The package opens no firewall ports. See Network and firewall.