Videos

Upload the videos you want to play on your screens. Before you can add them to a production playlist you must verify them on a real device — yourself, by physically watching the screen.

Uploading a video

Videos → Upload video.

• Pick the file from your computer (drag-and-drop works).
• Give it a descriptive title, owner company and optional notes.
• Click Upload — a progress bar appears. When it finishes, the video shows up in the list with status Pending verification.

Supported formats

Other formats (MOV, AVI, MKV) may work but may not play correctly on every device. If verification fails, convert the file to MP4 H.264 and re-upload.

Important — hardware rules. The resolution, bitrate and codec a device can play without stutter depend directly on its CPU/GPU and the codecs available. The same 4K MP4 that plays smoothly on a modern mini-PC can drop frames, distort audio or go black on an older Android box or Raspberry Pi. There is no single optimal setting — it depends on your fleet:

• Modern hardware (Android 10+ with a recent SoC, x86 with GPU, premium Apple TV/box): FHD 1080p / 4–8 Mbps is fine.
• Older / entry-level hardware (rk3188, rk312x, Android 5–7): drop to 1080p / 2–3 Mbps or even 720p if you see stutter.
• Linux PromoBrowser decodes through gstreamer — performance depends on installed plugins and the SoC's hardware-decode support.

This is why the verification step on a real device matters — it's the only way to confirm that your specific hardware plays your specific content without trouble.

Verification

Verification is done by you on one of your devices. Why: not every file plays well on every box — an MP4 that looks great on your laptop can fail on an older Android device because of codec, bitrate or resolution. The verification step makes sure you only push content to production that you've already seen work on your actual hardware.

Never send an unverified video or image to a production playlist — you risk black screens or clips that won't load.

How to verify

1. Videos → video row → Verify.
2. A dialog asks for:
   • Test device — pick one of your devices (ideally one representative of the production hardware). A dedicated verification device is recommended.
   • Playlist — the system creates (or reuses) a Verification playlist assigned to that device.
3. Click Continue. The device gets the playlist with your video on its next heartbeat (≤1 min) and starts looping it.
4. Walk over to the screen and check:
   • The video plays without stutter or artefacts.
   • Audio (if any) sounds right.
   • The aspect ratio is correct.
   • There are no glitches when the loop restarts.
5. If all good, back in the panel → Videos → the video will show a Validate button → click to mark it verified. From this moment you can add it to production playlists.
6. If it doesn't play well, re-encode (HandBrake / ffmpeg → MP4 H.264 1080p, bitrate 4–6 Mbps) and re-upload + verify again.

Recommended workflow

• Keep one dedicated Android and/or Linux device for verification, physically accessible (a back room is fine). Verify every piece of content there before pushing it to the client screens.
• If your production hardware is heterogeneous (several makes / generations), verify the same video on each distinct model at least once.

Managing videos

On each row:

• Preview — opens the video in a modal to review.
• Edit — change title, notes, company.
• Delete — removes the video from the server and from every playlist that contains it.

Before deleting, check the video isn't in use. Deletion is final.

Quotas

Each company has a maximum number of videos and a maximum file size configured in the plan. The system warns you when you hit the limit. To expand, contact support.