Skip to content

Known limits

TV Camera Popup is an Android app. It runs on TVs and streaming boxes with Android TV or Google TV, Android 8.0 or newer.

  • Samsung and LG TVs cannot use it. Samsung (Tizen) and LG (webOS) TVs do not run Android apps, and neither system lets an app draw over other apps. The popup cannot be brought to those TVs as it is. An Android TV or Google TV box plugged into such a TV works, for what is watched through that box.
  • Fire TV is not supported. The app has not been built for or tested on Fire OS.
  • What it has been tested on. A Sony BRAVIA 4K TV with Android 12, and Google TV emulators with Android 14 and Android 16. Other Android TV devices should work but have not been tried.
  • Android 17. Android 17 limits background audio, and it has not been checked whether camera sound still plays there. Muted video is not affected.
  • The app is not in any app store yet; it is installed by sideloading, see Getting started.
  • Many TVs hide the “display over other apps” setting, so the permission is granted with one adb command from a computer.
  • One popup shows at a time. A new request replaces the one that is showing.
  • A popup does not turn the screen on. A request sent while the TV is in standby is accepted and nothing is seen.
  • There is no camera grid: one camera shows at a time, and the viewer switches between up to 8.
  • At most 4 action buttons.
  • Sizes are presets (20%, 33%, 50% and 100% of the screen width) or an explicit width and height.
  • The app plays what the camera sends. It needs H.264 video over RTSP, or HLS or a progressive file over HTTP.

duck and pause depend on the app that is playing honoring Android audio focus. Some apps ignore it, and Android offers no way to lower or pause one specific other app. The Tablo app is one that ignores it, see Troubleshooting.

TVs have very few hardware video decoders, and some have effectively one. The app uses a software decoder by default so that it never takes the hardware decoder from the app underneath. A very large or high frame rate camera stream can drop frames on a software decoder; lower the camera’s stream settings if it does.

Some TV keys are handled by the TV itself before any app sees them, and the TV tells the popup nothing.

On the Sony BRAVIA (Android 12) the Input key is one: its input picker appears over an interactive popup, but the popup keeps the remote, so the picker cannot be used until the popup is gone. Press Back first, or wait for the countdown, which does not run while the picture is expanded.

Home does work: the popup closes and the TV goes home.

  • The listener is plain HTTP on the local network, and RTSP camera streams are not encrypted either.
  • Without an access token, anything on the local network can show a popup.
  • The access token and camera logins in requests travel in clear text. The token is a guard against accidents, not against someone who can watch the network.
  • Do not forward port 5001 from the internet to the TV.
  • It does not call anything: no callback, no webhook, no outbound request when a button is pressed. The caller reads the result.
  • It does not discover cameras or TVs; every address is given in the request.
  • It does not record or store video.
  • Snoozes are kept in memory and are forgotten when the TV restarts.