# Preview your filter

> Preview a filter in Nosmai Studio to see it composited live on your camera before you export. Choose a preview source (your camera, a bundled model, or an imported file), press play, and the Preview view shows the real engine render. You can also open a separate preview window or send the preview to a connected device.

> 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-your-filter/



## Overview

The preview in Nosmai Studio shows your filter composited live, the same way the
SDK renders it. You choose a preview source, press play, and the Preview view
shows the result. The camera is the default source, so the filter appears on a
real face straight away.

**Product:** Nosmai Studio · **Platform:** macOS, Windows · **Updated:**
6 October 2026 · **Reading time:** 7 minutes

## Prerequisites

- A project open in the editor.
- A working camera, or a bundled model, or a file to import as the source.

## Choose a preview source

The source picker is in the top bar:

- **Camera** (the default): your webcam. A green dot means a camera is available.
  Device names are blank until you allow camera access once.
- **Picture Model** or **Video Model**: bundled sample media, one pick away for
  when there is no camera.
- **Import**: a picture or video from disk (`png`, `jpg`, `jpeg`, `webp`, or
  `mp4`, `mov`, `webm`, `m4v`).

## Run the preview

1. Press **play** in the top bar. The stage switches to the Preview view and the
   engine renders the filter.
2. Allow camera access if your system asks.
3. Press **stop** to end the preview.

![A filter composited in the Preview view.](/images/studio/preview-running.png)

## Check it at different shapes

A filter ships to phones, tablets, and desktop webcams, so the same effect has to
survive every shape. The **target aspect** control previews each one without
changing the package:

- Source, 9:16 (phone portrait), 16:9 (landscape), 1:1 (square), 4:5 (feed crop).
- A **safe area** overlay marks the region every shape has in common.

Target aspect is an authoring check only. It is never written to the filter.

## Face-tracking model

The FaceMesh quality setting chooses the tracking model:

- **Lite** (default): lighter, what Studio has always used.
- **Full**: the model the mobile SDKs use, so it is the honest choice when you want
  to see how tracking behaves on a phone.

## Preview on another screen or device

- The **preview window** control opens a separate, always-on-top window that
  mirrors the filter, useful on a second monitor.
- A connected phone or browser can join through the live-preview bridge, shown on
  the status chip as "Live in" that device.

## Verify it worked

- The Preview view shows the filter on your source, updating live.
- Changing a layer updates the preview immediately.
- The status chip shows a measured frame rate while the preview runs.

## Common problems

| What you see | Why | Fix |
| --- | --- | --- |
| The preview is black | The engine has not painted yet, or camera access was denied | Allow camera access, wait a second, or stop and start the preview |
| Device names are blank in the source picker | Camera access has not been granted yet | Allow the camera once; the real names then appear |
| The filter looks right on one shape and wrong on another | It was authored against a single aspect | Use the target aspect control to check each shape, and the safe area overlay |
| A video preview option is disabled for export | The source is a still image | Choose a camera or video source to produce a preview video |

## Next steps

- [Check performance](/docs/studio/guides/check-performance/)
- [Export a package](/docs/studio/publishing/export-a-package/)
- [Modes and views](/docs/studio/interface/modes-and-views/)

## Reference

- [Modes and views](/docs/studio/interface/modes-and-views/)
