Nosmai Studio Preview on a device
Nosmai Studio / Guides / Preview on a device
Updated October 7, 2026

Send a filter from Nosmai Studio to a phone to see it running on real hardware. Studio and the device join over the same Wi-Fi network through the Nosmai Studio Companion app, which discovers Studio automatically. This is also the only way to run a game filter, because Lua game scripts run on a device, not in Studio.

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

  1. Put the phone and this computer on the same Wi-Fi network.
  2. Open the Nosmai Studio Companion app on the phone.
  3. 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

  1. With a device connected, open the preview device menu in the top bar.
  2. Choose Preview on device (or Run) to send the current filter.
  3. 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 seeWhyFix
No device appearsThe phone and computer are on different networksPut both on the same Wi-Fi network and reopen the Companion app
The device connects but nothing showsThe filter was not sentChoose Preview on device in the top bar to send it
The game does not respond on the deviceBlink or gesture detection needs a clear, well-lit faceImprove lighting and face the camera directly
A guest or public Wi-Fi blocks the connectionSome networks isolate devices from each otherUse a home or trusted network, or a personal hotspot

Next steps

Reference

Nosmai

An AR and AI company. Founded on the idea that the next decade of software will be visual, and that the tools for it should be within reach of anyone building.

Newsletter

Product updates and release notes. No spam.

© 2026 nosmai, inc · all rights reserved