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.
Grant the overlay permission
Section titled “Grant the overlay permission”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. Turn on debugging on the TV
Section titled “1. Turn on debugging on the TV”- On the TV open Settings > System > About.
- Move to “Android TV OS build” and press OK seven times, until the TV says you are a developer.
- 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.
- Note the TV’s address under Settings > Network & Internet.
2. Connect from the computer
Section titled “2. Connect from the computer”Replace TV_IP with the TV’s address:
adb connect TV_IP:5555The TV shows an “Allow USB debugging?” prompt.
Accept it, then check that the TV is listed as device:
adb devices3. Grant the permission
Section titled “3. Grant the permission”adb shell appops set com.workedge.tvpopup SYSTEM_ALERT_WINDOW allowThe command prints nothing when it works.
If more than one device is connected, add -s TV_IP:5555 after adb.
4. Check
Section titled “4. Check”Open TV Camera Popup on the TV. The settings screen shows “Overlay permission: granted”.
Or from the computer:
curl http://TV_IP:5001/statusThe 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.
If it does not work
Section titled “If it does not work”| 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. |
First things to check
Section titled “First things to check”curl http://TV_IP:5001/statusanswers, with"overlay_permission": true.- The “Show test popup” button on the app’s settings screen shows a color-bar card.
- 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.
Which TVs are supported
Section titled “Which TVs are supported”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.
Getting the app
Section titled “Getting the app”TV Camera Popup is not in any app store yet. For now it is installed by sideloading, see Getting started.
Report a bug
Section titled “Report a bug”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 /statusor the app’s settings screen, - the answer the app gave to your request, including
errororerror_text.
Do not send camera passwords or access tokens.
The app’s answers and its log already mask camera logins as ***.
TV Camera Popup is free and provided as is, without warranty or support. It is an independent project, not affiliated with, endorsed by or sponsored by Control4, Sony or Google; those names are used only to say what the app works with. Privacy policy · Help