# Preview on a device

> 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.

> For AI agents: the complete documentation index is at https://nosmai.com/llms/studio.txt

Product: Nosmai Studio
Group: studio-guides
Source: https://nosmai.com/docs/studio/guides/preview-on-a-device/



## 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](/docs/studio/tutorials/build-a-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 |

## Next steps

- [Build a blink game](/docs/studio/tutorials/build-a-blink-game/)
- [Preview your filter](/docs/studio/guides/preview-your-filter/)
- [Add reactions and gestures](/docs/studio/guides/reactions-and-gestures/)

## Reference

- [Glossary](/docs/studio/reference/glossary/)
