Why Does My CleanYourTV Launcher Crash When Loading External Shortcuts

Updated 2026-11-04

The CleanYourTV launcher on Android TV is useful for surfacing remote shortcuts, but it can crash when it attempts to load definitions from external sources such as network drives, cloud backups, or third-party Home app export files. The crash usually occurs during startup or when the user activates a shortcut that points to a missing or malformed path. This guide walks through the exact steps to stop the crash, verify the sources you enable, and recover a stable launcher setup without losing the shortcut functionality you need.

Why the launcher fails to resolve external shortcuts

CleanYourTV builds its shortcut list from three places: the built-in shortcut table, exports saved by other Home apps on the same device, and links shared via the Bluetooth or ADT protocol. When any of those sources contains an invalid path, a non-UTF8 entry, or a reference to a source that has been disconnected, the launcher throws an unhandled IOException and exits. Users see a sudden boot loop or a black screen shortly after powering the TV on, and the shortcut that appears to be broken is often one that points to a network share that is no longer mounted.

The most common triggers are:

• Shortcuts pointing to SMB shares that are offline
• Cloud backup files containing legacy LocalShortcut.xml entries
• Third-party Home apps that export shortcuts in an older format
• A corrupted CleanYourTV cache that stores stale references

If you keep the same shortcut set each week before updating firmware, you may have accumulated enough bad references to cross the failure threshold.

Check the shortcut sources before enabling them

Start with a clean slate. Boot into Settings > Apps > CleanYourTV > Storage and clear the cache and data. Then run the launcher with shortcut loading disabled: Settings > System > Home & Display > Custom Layout, turn off “Load External Shortcuts,” and restart the TV. Open the launcher and confirm you can reach the main home screen. Once you’ve verified basic operation, re-enable sources one at a time.

Test each source separately:

• Network shares: Disable SMB/NFS shares on the router, then toggle the external-shortcut option off in the launcher. If the crash stops, remove that share from the network.
• Cloud backups: Temporarily disable Backup & Restore for the Google account linked to your Android TV and reload the shortcuts from the local table only.
• Third-party Home apps: Uninstall the last Home app that exported shortcuts, then let CleanYourTV create a fresh table.

This isolation approach identifies which source is corrupted without losing your existing shortcuts.

How to edit the shortcut table and disable problematic ones

After confirming the launcher boots, open the Home screen and long-press a problematic shortcut. If the device supports it, choose Edit > Properties. In the detailed view, look for the source field and any path string. Shortcuts that show local paths like \\192.168.1.50\SharedFolder\Shortcut or URLs with query parameters are the usual culprits.

To disable a single shortcut without deleting it, use the long-press menu to select Disable. To permanently remove it, select Delete. Repeat this for every shortcut that references a file you cannot verify is online or physically connected. You can also export the current shortcut list from the launcher’s settings page, review it on a computer, and prune entries marked as coming from “Backup” or “Third Party.” After pruning, re-enable the external-shortcut option and reboot once.

If the crash recurs, the issue is not the individual shortcut but a corrupted global table. In that case, delete the entire shortcut section from the launcher settings, then let the launcher regenerate it from scratch with only local sources enabled.

Reset the launcher and rebuild the shortcut table cleanly

When source filtering alone does not fix the crash, a full reset is the reliable fix:

1. Go to Settings > Apps > CleanYourTV.
2. Clear cache, then uninstall the launcher.
3. Reboot the TV.
4. Re-download CleanYourTV from the Play Store or the official channel.
5. During first-run setup, choose “No shortcuts” as the starting profile.
6. Add shortcuts manually from nearby devices, or re-import a curated shortcut file created from a trusted local source.

Avoid restoring a previously backed-up shortcut set unless you have verified that all files referenced by those shortcuts still exist on the TV’s storage. If you must restore a set, do it in two phases: first import the list without activating the shortcuts, then activate them one by one with the launcher running in read-only mode.

A well-maintained launcher on Android TV adds value: it surfaces shortcuts placed on other smart TVs, keeps them grouped by category, and saves battery by skipping redundant network calls. The trade-off is a small amount of initial work to clean up corrupted references and a preference for local over remote shortcuts. For most households, keeping the shortcut table lean and avoiding automatic sync with backup services prevents the crash cycle entirely.

Preventing future crashes while keeping your shortcuts

The best defense is minimalism. Leave the external-shortcut auto-load feature off unless you control every device that holds a shortcut. Schedule a monthly check to remove old network shares from your router when you retire a device that hosted a Home app. When you install a new smart TV or streaming box, export shortcuts to the local table and avoid letting Cloud Backup write them across both systems at the same time.

By following these steps—clearing the cache before testing, isolating each shortcut source, rebuilding the table from trusted local entries, and keeping the external-shortcut setting disabled by default—you can eliminate the crash that occurs when CleanYourTV attempts to load external shortcut definitions. The launcher will start reliably, and your shortcuts will remain accessible from within the local network without relying on potentially unreliable remote or backup sources.

Related reading: more Android TV notes