Overview
Previewing in Studio shows a filter on your computer. Previewing on a device sends it to a phone over the same Wi-Fi network, so you see it on real hardware with a real camera. This also runs game filters, because their Lua scripts execute on a device, not inside Studio.
Product: Nosmai Studio · Platform: macOS, Windows · Updated: 7 October 2026 · Reading time: 8 minutes
Prerequisites
- A filter open in the editor.
- A phone with the Nosmai Studio Companion app installed.
- The phone and the computer on the same Wi-Fi network.
Connect a device
- Put the phone and this computer on the same Wi-Fi network.
- Open the Nosmai Studio Companion app on the phone.
- The app discovers this Studio automatically and connects. The connected device appears on the preview status pill in the Studio top bar.
A browser on the same network can join the same way and shows up as a connected device too.
Send the filter
- With a device connected, open the preview device menu in the top bar.
- Choose Preview on device (or Run) to send the current filter.
- The filter runs on the phone's live camera. Edits you make in Studio can be sent again to update it.
The status pill reads "Live in" the device name while a device is receiving the preview.
Why games need a device
Studio has no Lua interpreter, so a game script never runs inside Studio. The engine on the device runs it. So to test a game filter (for example the blink game), you connect a device and preview there. In Studio alone, a game's layers are visible but the script does not play.
Verify it worked
- The connected device appears on the preview status pill.
- Sending the filter shows it on the phone's camera.
- For a game filter, the game responds to input (such as a blink) on the device.
Common problems
| What you see | Why | Fix |
|---|---|---|
| No device appears | The phone and computer are on different networks | Put both on the same Wi-Fi network and reopen the Companion app |
| The device connects but nothing shows | The filter was not sent | Choose Preview on device in the top bar to send it |
| The game does not respond on the device | Blink or gesture detection needs a clear, well-lit face | Improve lighting and face the camera directly |
| A guest or public Wi-Fi blocks the connection | Some networks isolate devices from each other | Use a home or trusted network, or a personal hotspot |