CleanYourTV
Troubleshooting.

Find CleanYourTV troubleshooting for an ADB connection, APK installation error, Home button problem or black screen. Keep your device backup nearby.

Prefer a guided route?

Answer a few questions about your system and symptom.

Start guided troubleshooting
My TV is not found or ADB cannot connect.+

Check that both devices use the same local network, not a guest network. Confirm debugging is enabled and look for an authorization request on the TV. A computer firewall, access-point isolation or changed TV address can block access. Follow the upstream connection troubleshooting section instead of guessing a port.

Read upstream troubleshooting ↗
The APK fails to install or parse.+

First check whether you downloaded the Android phone app or built the TV launcher: they target different devices. Compare the Android version with the package requirements. A signature mismatch may mean another build is already installed. Read the exact upstream error guidance before removing any installed package.

Read upstream troubleshooting ↗
The Home button returns to the stock launcher.+

Default Home behaviour varies by firmware. Fire TV in particular limits third-party launchers. Read the exact model record and launcher instructions; do not disable the original launcher before its replacement has been checked.

Read upstream troubleshooting ↗
The Home screen is black or loops.+

Stop applying further changes. If your authorized connection still works, consult the backup and matching upstream recovery instructions. Device-specific firmware may re-enable packages at boot. Do not copy another TV’s disable list to solve this.

Read upstream troubleshooting ↗
Casting, HDMI or a streaming app stopped working.+

Review what was disabled and restore the affected packages using your own backup or the phone app’s undo controls. Network services and TV input components can be device-specific. Confirm the exact model record before trying again.

Read upstream troubleshooting ↗
I still see ads inside a video app.+

The project does not promise to block advertising within YouTube, Netflix or other streaming apps. Removing manufacturer home-screen recommendations is different from filtering in-app advertising.

Read upstream troubleshooting ↗

Original upstream troubleshooting ↗

Recovery guide