# CleanYourTV Troubleshooting: ADB, APK & Home Screen

Canonical: https://clean-your-tv.net/guides/troubleshooting/
Language: en
Updated: 2026-10-24

# 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](https://clean-your-tv.net/diagnose/)

Search symptoms or errors

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 ↗](https://github.com/Gathin23/cleanyourtv/blob/f9f0c5353e65c5003d5f2f45784a30c5dee19ecb/docs/TROUBLESHOOTING.md)

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 ↗](https://github.com/Gathin23/cleanyourtv/blob/f9f0c5353e65c5003d5f2f45784a30c5dee19ecb/docs/TROUBLESHOOTING.md)

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 ↗](https://github.com/Gathin23/cleanyourtv/blob/f9f0c5353e65c5003d5f2f45784a30c5dee19ecb/docs/TROUBLESHOOTING.md)

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 ↗](https://github.com/Gathin23/cleanyourtv/blob/f9f0c5353e65c5003d5f2f45784a30c5dee19ecb/docs/TROUBLESHOOTING.md)

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 ↗](https://github.com/Gathin23/cleanyourtv/blob/f9f0c5353e65c5003d5f2f45784a30c5dee19ecb/docs/TROUBLESHOOTING.md)

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 ↗](https://github.com/Gathin23/cleanyourtv/blob/f9f0c5353e65c5003d5f2f45784a30c5dee19ecb/docs/TROUBLESHOOTING.md)

[Original upstream troubleshooting ↗](https://github.com/Gathin23/cleanyourtv/blob/f9f0c5353e65c5003d5f2f45784a30c5dee19ecb/docs/TROUBLESHOOTING.md)

No matching topic. Try a shorter search, or browse upstream troubleshooting.

[Recovery guide](https://clean-your-tv.net/guides/recovery/)