Troubleshooting

Common problems and their solutions

No HDMI signal

  • For the Raspberry Pi 4, use HDMI0 for your primary display.
  • Switch your monitor/television to the correct source and check your cables.
  • Switch on your monitor/television before you power up your Raspberry Pi.
  • The configured HDMI mode is not supported by your display. See this topic
  • In case of a dual display setup, your 2nd display has to support the same resolution/frame rate as your first display is set to. Also be sure your 2nd HDMI output is enabled in the system settings section of the configuration menu.

Bad display resolution (unreadable)

  • At startup Camplayer OS requests supported display modes/resolutions (EDID) and tries to select a sensible one. Under some circumstances Camplayer OS fails to communicate with the display (Case 1). In other cases the selected resolution isn’t ideal and/or low resolution (Case 2).
    Case 1: You can use config.txt to set a fixed display mode. Instructions part 1 part 2
    Case 2: You can set a custom HDMI mode in system-config.ini. Instructions part 1 part 2

Video playback interruptions

  • Unreliable network connection, low bandwidth. A wired connections is always better than a wireless connection. A minimum network speed of 20Mbit/s should be sufficient for 90% of the cases. Network speed is increasingly important when you configured multiple screens with automatic rotation as streams need to be pre-buffered in the background. You can verify this with the speedtest functionality in the configuration menu.
  • Unsupported or experimental video codecs, the video codec should be h264, h265 (HEVC) and others are experimental.
  • Your streams are exceeding the capabilities of your Raspberry Pi. Try reducing the number of windows per screen. Alter camplayer advanced settings to “best performance” in the configuration menu.
  • Is your stream playing correctly when you open it in VLC media player? If not, the problem lies somewhere in the provided stream, solve this first. As a hint, a possible cause can be that the stream is encrypted.
  • Your streams are exceeding the capabilities of your Raspberry Pi. Try reducing the number of windows per screen. Alter camplayer advanced settings to “best performance” in the configuration menu.
  • For RTSP, try using RTSP over UDP (when adding streams), this is required for some cameras.
  • Does it only happen after a reboot? See this topic

CEC remote control not working

  • Are you sure CEC is enabled on your Raspberry Pi? There is a ‘Enable CEC’ setting under the advanced system settings.
  • Are you sure CEC is enabled on your Television? This can be named CEC, Anynet+ (Samsung), BRAVIA Link/sync (Sony), EasyLink (Philips), VIERA Link (Panasonic), SimpLink (LG) etc.
  • Monitors usually don’t support CEC.
  • Some televisions are just incompatible with the CEC standard.
  • For the Raspberry Pi 4, only HDMI0 supports CEC.

Stream preview not working in the setup wizard

  • Your stream URL is wrong.
  • Your stream type is not supported.
    The stream codec must be H264 or MJPEG.
    MPEG2 is also supported on non RPI4 devices, but you need a separate license.
  • You can check your stream URL and type with VLC media player on another computer.
  • For RTSP, try using RTSP over UDP (when adding streams), this is required for some cameras.

My keyboard does not work correctly.

  • Reconfigure your keyboard, the default mode is English (Qwerty). Open the configuration menu, navigate to system settings and then to ‘CONFIGURE KEYBOARD’. The first step is to select the correct model, usually ‘Generic 105-key PC (intl.)’ is fine. Then select your language, you might have to press ‘Other’ to get the full list. Now, select your keyboard layout and follow the on screen instructions. A full system restart is required before these changes take effect.

IP addresses are changing unintentionally

  • Camplayer OS scans all configured devices on startup to adapt for changed IP addresses. This can cause problems for rather exotic network configurations. In this case, you can disable this scanning feature. Instructions part 1 part 2

Last modified April 21, 2021: doc update (9026333)