Troubleshooting
Start with the status page at https://<wall computer>:8730/. It shows the receiver state, the current sender and the last error with what to do.
MT Cast is not in the video inputs
- Check the service. On Ubuntu, run
systemctl status mt-screencast. On Windows, check that MT Cast Companion runs in Services. - On Ubuntu, check the log with
journalctl -u mt-screencast. If it sayscannot open /dev/v4l2loopback, the kernel module did not load. With Secure Boot on, a module built on the computer needs its key enrolled. See Secure Boot.
The wall is not in the AirPlay list
- Is MT Cast on a canvas? The wall advertises itself only then, unless
[airplay] advertise=always. - Is the visitor's device on the same network as the wall? See Network and firewall.
- On Windows, is Bonjour Print Services installed? Uninstall it; it is not needed and can block the wall's own announcement.
- Did the wall's AirPlay name change after an update to 0.9.1 or later? The wall gets a new stable device ID once, so a Mac, iPhone or iPad may need to pick the wall again.
- Is AirPlay on? Check
[airplay] enabled. - Does the guest Wi-Fi isolate clients? That blocks AirPlay discovery.
AirPlay asks for a PIN and refuses it
- Read the PIN from the card again. A random PIN changes for each connection.
- Type only the digits.
- Check
[airplay] pin. Afixed:value is the PIN to use.
MT Caster is not on the card
- Check
[caster] enabledand[webrtc] enabled. Both aretrueby default. - Check
[web] listen.localhosthides MT Caster and browser share. - Check the wall's graphics card. Without a hardware H.264 decoder (NVIDIA, Intel or AMD), the card leaves MT Caster out.
The card links to the wall instead of apps.multitaction.com
The card shows https://<wall>:8730/get when the wall cannot reach the MT Caster download on apps.multitaction.com.
- Check that the wall computer can open
[caster] public-download-urlover HTTPS (TCP 443 toapps.multitaction.com). - After a fix, the card changes within 10 minutes.
MT Caster says the join code is wrong
- Read the code again from the card. It changes after each use and after 15 minutes.
- After five wrong tries in a minute, wait a minute before you try again.
MT Caster says no room has that join code
MT Caster finds rooms on the network by mDNS and asks each one about the code.
- Read the code again from the card.
- Check that the laptop is on the same network as the room. A guest network that isolates clients, or a router between the laptop and the wall, blocks room discovery as it blocks AirPlay. See Room discovery for MT Caster.
- Check the wall's status page: Room discovery (MT Caster) should say "announced as" and the room name. "Not announced" means MT Caster is switched off, the wall is not licensed, or, on Ubuntu,
avahi-daemonis not running. - If the network blocks mDNS, use Enter the wall's address in MT Caster's connect window and type the address of the wall's join page.
MT Caster cannot connect to the wall
- Check that the laptop can open
https://<wall>:8730/get. If it cannot, a firewall or network setting blocks TCP 8730. - Check that the UDP range 50730 to 50739 is open. Pairing can work and the picture still not arrive when UDP is blocked.
- On Windows walls, check that the network profile is Domain or Private.
The browser page says it needs HTTPS
Set [web] https=true. It is the default from 0.9, but a wall installed earlier keeps its old setting. See Casting from a browser.
The browser shows a certificate warning
This is normal when the wall makes its own certificate. Choose Advanced, then Proceed. To remove the warning, use a certificate from your IT team. See HTTPS and certificates.
The picture is blocky or stutters
- The wall lowers the bitrate when it loses packets. Check the Wi-Fi signal, or put the visitor's laptop on a wired connection.
- Check
[webrtc] max-bitrate-kbps. The range is 1000 to 20000. The default is 6000. - At 4K a cast uses up to 20 Mbit/s. On a busy Wi-Fi network, choose 1440p or 1080p under Cast resolution.
MT Cast is black or the old size after changing the cast resolution
Canvus keeps MT Cast open in the format it had. Close the MT Cast input on every canvas and add it again from the video inputs menu, or restart Canvus. On Ubuntu, then choose Apply now on the settings page if the status page still says "MT Cast runs at ... for now".
There is no sound
- MT Cast starts muted. Tap the speaker button on the MT Cast widget.
- MT Caster: check that Share sound is ticked in its tray menu. If MT Caster says "Sharing without sound", the laptop has no sound output it can capture; the reason follows in the message.
- Browser: Chrome and Edge send sound only when the visitor turns on Also share tab audio (or, on Windows with the entire screen, Also share system audio) in the sharing window. Firefox and Safari never send sound. The join page says whether the share has sound.
- Before version 0.9.6, only AirPlay casts had sound.
- Open the status page. The Sound line says where the sound goes and whether Canvus takes it. Sound received shows the level while the visitor plays something; Sound from MT Caster or a browser says whether the current cast sends sound.
- Windows: an MT Cast placed before version 0.9.4 has no sound. Remove it and place it again.
- Ubuntu: run
pactl list sources shortas the desktop user.mt_cast_1must be in the list. If it is not, runsystemctl --user restart mt-cast-audioand checksystemctl --user status mt-cast-audio. - Check that
[companion] audioistruein Settings.
I lost the network access password
On the wall PC, open MT Cast settings from the tray icon. No password is needed there. Under Network access password, set a new one. See Settings password.
What to send to support
Send MultiTaction support the log (journalctl -u mt-screencast on Ubuntu, or companion.log on Windows), the version of MT Screencast (from 0.9.7 it is in the bottom-right corner of the card) and the type of device that cast.