Skip to content

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 says cannot 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. A fixed: value is the PIN to use.

MT Caster is not on the card

  • Check [caster] enabled and [webrtc] enabled. Both are true by default.
  • Check [web] listen. localhost hides 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 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-url over HTTPS (TCP 443 to apps.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-daemon is 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 short as the desktop user. mt_cast_1 must be in the list. If it is not, run systemctl --user restart mt-cast-audio and check systemctl --user status mt-cast-audio.
  • Check that [companion] audio is true in 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.