How to Sideload an iPhone Shortcut onto Android TV

Updated 2026-10-28

The first thing most people notice when they pick up an iPhone shortcut and try to use it on an Android TV running CleanYourTV is that it simply isn’t there. Apple’s shortcut ecosystem is a closed loop: the Shortcuts app, the Share Sheet, and the set of registered actions that get mapped to physical buttons or remote input. Android TV doesn’t have any of that. The only way in, if you want to bring a shortcut over, is to sideload a small package that exposes its actions to the Android side.

That process is straightforward but finicky. It requires root access or an ADB-signed APK, a little patience, and faith in the action namespace mapping. This guide walks through why the problem exists, how to do it, what you’re giving up, and what works best for a CleanYourTV user.

Why the shortcut system can’t just transfer

Apple’s Shortcuts works by registering actions in an iCloud-backed system the guest OS can’t see. iOS pushes actions to the Share Sheet and to the home screen, and the phone handles invocation. Android TV, especially under CleanYourTV which adds a home-screen launcher layer on top of the stock Android TV interface, has no equivalent API surface.

The closest analogue on Android TV is the Action Manager system (the same one Google uses for intent resolution), but it only understands intents with explicit components, data URIs, or action types. Nothing you install from the Play Store as an “iOS Shortcut” will bridge that gap. Sideloading a .apk that contains a BroadcastReceiver or an IPC handler registered with the Android system can expose custom actions as buttons or remote-accessible commands, but the handoff is mechanical, not semantic.

CleanYourTV changes the calculation slightly. The launcher adds a notification shade, quick-launch widgets, and a settings hub. Its strength is giving you more surfaces on which to place a manually installed action, but it also adds a layer of abstraction that can make debugging sideloading failures harder. If something breaks, you’ll want to check both the launcher config and the underlying APK.

Step-by-step: preparing and sideloading

First, confirm the exact file you need. The shortcut file format you’ve downloaded from iOS — usually a .shortcut bundle or a .idm/.hbs file — is not directly usable on Android. What sideloading gives you is a raw .apk that contains the logic of the shortcut, typically wrapped in a BroadcastReceiver or a PendingIntent-friendly component.

On a Mac or Linux machine with adb installed, the steps look like this:

1. Put the source iPhone shortcut file aside. You’ll need its underlying actions, so open the original shortcut on iOS once, and copy the list of actions, the arguments, and the triggers. Write them down or save them as a text note.
2. Find the equivalent source on Android’s side — often a developer’s sample APK or a converter tool that turns iOS Intents into Android Intents. Some apps (e.g., Shortcut Converter by third parties) let you paste the ios path and generate an APK, but the conversion quality varies.
3. Build or acquire the .apk. For a simple conversion, use jadx on the resulting APK to verify the intent filters. The critical part is that the receiver or action handler is declared with a name matching the shortcut’s identifier, and that the intent data is mapped correctly.
4. Push the APK to the TV: adb push yourapp.apk /sdcard/admin/.
5. Install it with root access: adb shell install -r /sdcard/admin/yourapp.apk. The -r flag replaces an existing version if one’s present.
6. Once installed, the new shortcut appears in CleanYourTV’s widget and launcher menu if you’ve registered it in the Action Manager. You can then trigger it with a remote press or voice command if you’ve bound it to a key event.

If you don’t have root yet, adb install --download can work temporarily for testing, but for persistence across reboots you need the root path. A common alternative is to use Magisk to add an /system/app entry and flash it to the boot image, but that’s overkill unless you’re maintaining multiple custom builds.

Trade-offs and what really works

Sideloading an iPhone shortcut onto Android TV is not a plug-and-play migration. You’re paying real costs, and for most people the effort is better spent on a native alternative.

Benefits. You get exactly the same sequence of actions you used on the iPhone — for example, “open Spotify, play a playlist named ‘Focus,’ dim the screen” — expressed as a single button press on your TV. That consistency feels natural if your typical workflow involves phone shortcuts.

Costs. First, you lose iOS security updates on that app. The APK is untrusted, and BroadcastReceivers have broad permissions. Second, the mapping is manual. Every action you convert must be re-entered by hand; there is no automatic translation of gestures. Third, Android TV’s remote control has limited input, so complex shortcuts become one-shot commands that are hard to invoke accurately.

A short list of realistic options and their strengths:

• Google Assistant routines. Bind the same action to a voice command in Assistant. Works without installing anything extra, but the action is voice-bound, not remote-button-bound.
• Android’s built-in Shortcuts (Android 12+). If your TV is on a recent platform, you can create a routine with the shortcuts app and assign it to a tile. Same idea, but native to Android.
• A dedicated smart home hub. If you have a Chromecast or a Google Home device, the supported actions are limited, but at least the device is maintained by someone who supports updates.

For CleanYourTV users specifically, the launcher’s widget bar is now a strong place to put a native shortcut tile. Install a simple custom shortcut app from F-Droid or the Play Store, pin it in the launcher, and use voice activation for the fiddly bits. That pattern avoids the sideload risk entirely.

Where CleanYourTV helps (and where it limits)

CleanYourTV’s custom launcher adds a widget tray and a notification shim that sit alongside the system launcher. Those surfaces are where you should place your converted shortcuts. The launcher’s “Actions” section lets you map a button or voice phrase to a PendingIntent, so once your sideloaded APK is running as a BroadcastReceiver, a single remote tap can fire it.

But CleanYourTV is a wrapper, not a full replacement for the Android TV home screen. Some of the deeper shortcut features — like the “quick settings” tiles, or persistent background execution — may be gated behind the stock launcher. If a shortcut needs to run while the TV is in Game Mode or while the screen is off, test under those conditions. CleanYourTV sometimes disables certain background services when the display is locked.

In short, use the launcher for the visible action, keep the heavy lifting in a custom APK, and accept that sideloading is a workaround rather than a first-class feature. For daily use, the combination of a native shortcut on Android TV plus a Google Assistant routine for voice-triggered actions covers the vast majority of the value you’d get from moving all your iPhone shortcuts over verbatim.

Related reading: more Android TV notes