How to Turn an iPhone Shortcut Into an Android TV Action

Updated 2026-10-28

Android TV users who want to run iOS automation shortcuts on their Samsung Crystal or LG C2 TV often try copying the link into the Plex app or a local file. That fails because iPhone Shortcuts are not native Android action files, and the Android TV side-loading mechanism requires a proper .tiv or .action package signed with the correct update channel. The conversion path is straightforward, but getting it right matters — an improperly packaged action will refuse to install, and a broken package can freeze the launcher.

The CleanYourTV launcher is useful here because its developer tools expose a simple way to test sideloaded actions without waiting for a store update cycle. In practice, converting an iPhone Shortcut becomes a matter of re-encoding the shortcut to launch an Android intent, then handing that package to the TV via a USB or wireless side-load method the launcher supports.

Why the conversion has to happen at all

An iPhone Shortcut lives in the Shortcuts app as a sequence of triggers, apps, and data. It produces a URL or a deep link. Android TV needs an action package that declares intents, permissions, and sometimes a manifest XML. Simply pasting a shortcut link into the Google Assistant/TV voice input often resolves to “Could not find action,” because the underlying action registry never received the intent.

The conversion bridges two worlds. You keep the shortcut designer experience — voice triggers, swipe gestures, and contextual awareness from iOS — while producing an artifact the Android TV side-load system accepts. Once converted, the action can live alongside the CleanYourTV extensions you install for screen cleaning, app sorting, and remote control.

Step-by-step: extracting and repackaging the shortcut

First, open the Shortcuts app on your iPhone and edit the target shortcut. The final step before exporting is to ensure the URL it calls uses HTTPS and points to a reachable endpoint. Android TV will reject an action pointing at an HTTP address, and the verification error is usually shown in the launcher’s debug log.

Next, choose an export format. For Android TV side-loading, the recommended format is a .tiv bundle containing the action XML and any attached resources. Some shortcut authors prefer .action bundles when they want the action to persist across TV restarts. If you need persistent triggers (for example, launching a routine whenever a smart TV boots), build a .action package with persistence enabled; otherwise stick with .tiv for temporary use.

Once you have the bundle, generate it from the shortcut editor. The exact command line or GUI export option varies by iOS version — check Apple’s support article for your release before starting. If you’re working in a team environment, commit the bundle alongside your sideloading scripts so that the CleanYourTV CI pipeline can verify that the package still installs without errors.

Then, transfer the bundle to the Android TV. The CleanYourTV launcher has a built-in side-load drop zone, but you also need a supported method such as ADB push or a USB mass-storage drive if you’re using a wired connection. Place the .tiv or .action file in the root of the TV’s sideload folder and trigger the installation through the launcher’s settings menu. On a wireless side-load path, make sure the TV can reach the source host over the network — firewall rules and local DNS matter more than most people expect.

Settings that make or break the install

CleanYourTV includes a diagnostics tab that validates the action bundle before it touches the system. Use it. The tool will flag missing permissions, malformed manifest entries, and incompatible target Android API levels. It will also report whether the action is safe to load — some conversions of complex shortcuts that include multiple Run Script actions get flagged because those scripts may assume iOS execution context.

When you adjust the settings, pay special attention to three things:

• Intent filter correctness — the action must declare every app it might touch, and the data schemas must match what the TV’s installed apps actually accept.
• Permission scope — include only the accesses the action truly needs. Over-granting permissions shows up in CleanYourTV’s permission audit as a red flag, and the TV may prompt you to deny during side-load.
• Update channel consistency — a shortcut exported from iOS 17 may reference APIs absent in Android 14. Update the action bundle’s manifest target to the minimum platform level you intend to run on, or conditionally compile separate versions.

Skipping these checks tends to cause the launcher to hang during installation, or worse, to load partially and leave the TV stuck on a spinner. Restart the TV and re-run the install if the debug log shows a malformed intent filter.

Trade-offs, risks, and best practices

The main benefit is reusing a shortcut you’ve already written in a familiar environment. That avoids duplicating the workflow in the Android TV settings app, which itself has limited shortcut support compared to iOS.

However, you lose some iOS-specific features when you side-load on the TV. For example, some shortcuts rely on the iOS Shortcuts inspector or on Face ID confirmation flows that don’t map cleanly onto a remote-controlled TV. Expect a flatter UI, and consider adding a dedicated remote button for the most-used actions.

Another trade-off is performance. A converted action that wraps a background service call can drain battery faster than a native Android action. Test the action under typical use — opening a streaming app, toggling a smart plug — and verify that the TV doesn’t enter an unexpected sleep state.

A short list of what to do before committing the side-load:

• Run the action on a test TV with a minimal app set to isolate side effects.
• Keep the first installation offline (no streaming, no smart-home calls) to confirm installability.
• Record the manifest output and compare it against the original shortcut’s action list.

With the conversion done correctly and CleanYourTV’s validation tools used as part of the pipeline, converting an iPhone Shortcut into an Android TV action for sideloading becomes a reliable way to extend your existing iOS automation routines onto the living room display.

Related reading: more Android TV notes