Videos Will Not Play or Stutter | easyCMS Digital Signage

Video is where cheap hardware shows its limits. A video that plays perfectly on your laptop can be black, skipped or juddering on a signage player, because playback is done by the device’s own hardware decoder and every device supports a slightly different set of formats.

The 90% fix: re-encode the video

Most video problems disappear when the file is re-encoded to the conservative, universally supported profile that signage devices are built for:

Container: MP4
Video codec: H.264, Baseline or Main profile (not High 10, not H.265/HEVC unless you know your device handles it)
Resolution: match the region it plays in, 1920×1080 maximum for Full HD players. A 4K file on a Full HD player is wasted bandwidth at best and a black screen at worst.
Bitrate: 2–6 Mbps is plenty for signage. Very high bitrates are the most common cause of stutter.
Frame rate: 25 or 30 fps
Audio: AAC, 128 kbps stereo, include an audio track even for silent video; some decoders dislike video-only files.
Web optimised / faststart: on

HandBrake is free and does all of this: pick a standard MP4 preset, set the resolution, tick web optimisation, and export. If a file misbehaves, re-encoding it is faster than diagnosing it.

If re-encoding does not fix it

Switch the video engine (Android)

Android players can decode with either engine. Open Displays → Display Settings for the profile that display uses and change the video engine setting, then let the player collect and restart. If it is on the modern engine, try the legacy Android media player, and vice versa. Some cheap devices only work properly with one of the two.

Switch to external storage (Android)

Some Android devices cannot play video reliably from internal storage. In the player’s settings on the device, switch the media library to external storage (SD card or USB), then let it re-download. This is a well-known fix for devices that show a black region where the video should be.

Check the file actually downloaded

A video that never arrived cannot play. Confirm the player shows a completed download, see Display is Online but Content Never Changes. Large videos over a slow link can take hours.

Look for a blacklist entry

When a device fails to decode a file, the player blacklists it so it stops retrying. The player’s status window lists blacklisted media. That is your confirmation the problem is the file or the decoder, not the schedule. Fix the file, then clear the blacklist for that display from its row menu.

Update the device firmware

Manufacturers add and fix codecs in firmware updates. On a device that struggles with everything, a firmware update is worth trying before replacing hardware.

Stuttering rather than failing

Stutter is almost always the device being asked for too much:

Too high a bitrate or resolution for the hardware.
Several videos playing in different regions at once, most low-cost players can only hardware-decode one stream.
A heavy animated overlay or webpage widget on top of the video.
Storage that is nearly full, or a slow SD card.

Simplify the layout first, then reduce the bitrate. If a single 1080p video at 4 Mbps still stutters, the device is the limit, our players are specified for this workload.

Streams and live video

Live streams (RTSP, HLS) are far more fragile than files: they depend on the network holding up continuously, and on the device supporting that specific stream format. Test the stream URL on the device’s own browser first. HLS over HTTPS is the most reliable choice; RTSP support varies enormously by device.