Android TV permissions

Grant tvusage permissions with ADB

Use this only when Android TV settings cannot grant the required tvusage permissions directly, especially inside a restricted or child profile.

  1. 1

    Set up ADB on your computer

    Install ADB on your desktop or laptop and keep the terminal ready.

  2. 2

    Unlock developer mode and connect to the TV

    Navigate to Android TV Settings, then Device preference, then About. Select Build seven times to enable Developer options. Then go to Network & Internet, choose your connected network, and find the Android TV IP address.

    adb connect <ANDROID_TV_IP_ADDRESS>
  3. 3

    Open the restricted profile if needed

    If you want to grant access inside a restricted or child profile, switch the Android TV into that profile before running the profile-specific commands.

  4. 4

    Find the Android user ID

    Run the command below. The first UserInfo entry usually has user ID 0 for the main profile. A second UserInfo entry, such as user ID 12, can be the restricted or child profile.

    adb shell pm list users
  5. 5

    Grant the source-backed tvusage permissions

    The tvusage app package is in.codeseed.tvusage. The app source declares Usage Stats access as android.permission.PACKAGE_USAGE_STATS and Display Over Other Apps as android.permission.SYSTEM_ALERT_WINDOW.

    adb shell appops set --user <USER_ID> in.codeseed.tvusage GET_USAGE_STATS allowadb shell appops set --user <USER_ID> in.codeseed.tvusage SYSTEM_ALERT_WINDOW allow

    Use user 0 for the main profile, or replace <USER_ID> with the restricted profile ID shown by adb shell pm list users.

After granting access

Reopen tvusage in the same Android TV profile and check the permissions screen. If you still cannot use tvusage, contact support@tvusage.app.