Nosmai Studio Preview your filter
Nosmai Studio / Guides / Preview your filter
Updated October 6, 2026

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.

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.

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 seeWhyFix
The preview is blackThe engine has not painted yet, or camera access was deniedAllow camera access, wait a second, or stop and start the preview
Device names are blank in the source pickerCamera access has not been granted yetAllow the camera once; the real names then appear
The filter looks right on one shape and wrong on anotherIt was authored against a single aspectUse the target aspect control to check each shape, and the safe area overlay
A video preview option is disabled for exportThe source is a still imageChoose a camera or video source to produce a preview video

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