Troubleshooting

A target will not start

• Try Local Simulation. If it works, inspect Bluetooth permission and radio availability.
• Stop other BLE peripheral apps and retry.
• Read the Session log; permission denial and unsupported platform behavior are reported there.

The LAN editor does not connect

• Confirm both devices are on the same trusted network.
• Keep the app running and verify the server still shows port 8765.
• Restart the server to generate a new PIN, then reload the browser page.
• Client isolation on guest Wi-Fi prevents local devices from reaching each other.

A script says it cannot be saved or run

• “Multi-file scripting is turned off” — the script is split across several files and that capability is not enabled for your build yet. It still opens and can be read; it cannot be edited or run until it is. A single-file script is unaffected.
• A split script refuses to start after an import: open it and check every file, not just the first. The entry file is the one that runs, but it can require the others, and all of them execute.
• Split into files is missing from a script’s row because that script has already been split. Crossing over happens once and is not undone by deleting files again.

A host does not list the HID keyboard or mouse

Which hosts accept a Bluetooth keyboard or mouse is decided by the host, not by the Studio. These are the results we have measured:

Host	Result
macOS	Pairs and receives input
iOS / iPadOS	Pairs and receives input
Android phones and tablets	Pairs and receives input
Android TV / Google TV	Does not appear in Pair accessory

Two things to check first:

• Look for the on-air name, not the name in the catalog. The keyboard advertises as HID KB and the mouse as HIDMouse. “HID Keyboard” and “HID Mouse” are display names and never appear on air.
• Pair from the host’s own Bluetooth settings, not from an app. The keyboard is a standard HOGP peripheral and the host’s normal pairing flow is what finds it.

Android TV and Google TV

A television’s Pair accessory screen will not show it, and this cannot be fixed from the Studio. That screen discovers accessories over classic Bluetooth and admits them by Bluetooth device class — a keyboard, a mouse, a headset. A Bluetooth Low Energy peripheral has no device class to present, and an Android app cannot give itself one, so it is filtered out before the screen ever draws.

This is a property of how televisions pair accessories, not a defect in the peripheral: the same keyboard pairs normally with every host in the table above.

A purchase is missing

On Android, use Restore purchases in Settings → Plan & Billing. The device must be signed in to the Play account that made the purchase.

On macOS, use the license recovery action in Settings → Plan & License.

Reinstalling or restoring files does not restore entitlement proof.

A library appears incomplete

Do not repeatedly save over it. Export the library if the command is available, retain the original files, and contact Support. Newer or corrupt storage schemas are deliberately left untouched.