Skip to content

Help

TV Camera Popup is free to use and is provided as is, without warranty of any kind and without support. This site is the help: everything known about the app is written down here.

Most problems with a new install come down to one thing: the app has not been given permission to draw over other apps. This page shows how to grant it, then where to look next.

TV Camera Popup needs Android’s “display over other apps” permission to show a popup over what is playing. Many TVs do not show that setting anywhere in their menus, so it is granted once from a computer with adb.

You need a computer on the same network as the TV, with adb from the Android SDK Platform-Tools.

  1. On the TV open Settings > System > About.
  2. Move to “Android TV OS build” and press OK seven times, until the TV says you are a developer.
  3. Open Settings > System > Developer options and turn on “USB debugging”. If the TV shows a separate “Wireless debugging” or “Network debugging” switch, turn that on as well.
  4. Note the TV’s address under Settings > Network & Internet.

Replace TV_IP with the TV’s address:

Terminal window
adb connect TV_IP:5555

The TV shows an “Allow USB debugging?” prompt. Accept it, then check that the TV is listed as device:

Terminal window
adb devices
Terminal window
adb shell appops set com.workedge.tvpopup SYSTEM_ALERT_WINDOW allow

The command prints nothing when it works. If more than one device is connected, add -s TV_IP:5555 after adb.

Open TV Camera Popup on the TV. The settings screen shows “Overlay permission: granted”.

Or from the computer:

Terminal window
curl http://TV_IP:5001/status

The answer must contain "overlay_permission": true.

The permission is kept across TV restarts and app updates. It is lost if the app is uninstalled. When you are done you can turn “USB debugging” off again; the permission stays.

What happens What to do
adb connect says the connection was refused or timed out Debugging is not on, the address is wrong, or the TV and the computer are on different networks.
adb devices shows unauthorized Accept the “Allow USB debugging?” prompt on the TV. If it does not show, turn “USB debugging” off and on again.
adb devices shows offline Run adb disconnect, then connect again.
The command prints an error about an unknown package The app is not installed on that device, see Getting started.
  1. curl http://TV_IP:5001/status answers, with "overlay_permission": true.
  2. The “Show test popup” button on the app’s settings screen shows a color-bar card.
  3. The camera’s address plays in a desktop player such as VLC, from a computer on the same network.

Then see Troubleshooting for the full list, and Known limits for what the app cannot do.

TVs and streaming boxes with Android TV or Google TV, Android 8.0 or newer. Samsung and LG TVs are not supported, because their systems do not let an app draw over other apps.

TV Camera Popup is not in any app store yet. For now it is installed by sideloading, see Getting started.

There is no support service: questions about setting up the app, a camera or a home automation system are not answered.

Bug reports are welcome at support@workedge.com. They are read, but a reply or a fix is not promised.

In a bug report, include:

  • the TV’s brand and model, and its Android version,
  • the app version, from GET /status or the app’s settings screen,
  • the answer the app gave to your request, including error or error_text.

Do not send camera passwords or access tokens. The app’s answers and its log already mask camera logins as ***.