Nosmai Studio Make your first filter
Nosmai Studio / Get started / Make your first filter
Updated October 6, 2026

Build and preview your first AR filter in Nosmai Studio from a template, then export it as a .nosmai package. This tutorial opens the Cat Ears template, previews it on your camera, adjusts a layer, and exports, so you see the whole Studio workflow once end to end. It takes about 15 minutes.

Overview

This tutorial builds and previews your first AR filter in Nosmai Studio, then exports it as a .nosmai package. It starts from a template so you see a finished filter's layers, previews it live on your camera, changes one layer, and exports. By the end you will have seen the whole Studio workflow once.

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

Prerequisites

1. Open a template

A template opens as ordinary editable layers, so it is the fastest way to see how a filter is put together.

  1. On the home screen, open Templates in the left rail.
  2. Open Cat Ears. It loads into the editor.

The editor shows the filter's layers on the right, grouped by where they draw: cat ears over everything, a sparkle shader, a beauty layer on the face, and the camera at the bottom.

A filter open in the Studio editor, with its layers listed on the right.

To start from scratch instead, press New filter on the home screen and pick a start point. Either way, a filter is just layers you can add to and change.

The New Filter dialog with its start points.

2. Preview it on your camera

  1. In the top bar, confirm the preview source reads Camera. Camera is the default; if it shows a bundled model instead, open the picker and choose your camera.
  2. Press the play button in the top bar to start the engine preview.
  3. Allow camera access if your system asks. The preview opens on the Preview stage view and shows the filter on your face.

The cat ears follow your head, the sparkles track your face, and the beauty layer smooths your skin.

3. Change a layer

  1. In the Layers panel, select the Beauty layer.
  2. The inspector opens below the layer list. Open the Skin controls.
  3. Lower Smoothing toward 0.2. Watch the preview update live as you drag.

Every layer works this way: select it, and its properties appear in the inspector beneath the list.

4. Check performance

  1. In the stage view switcher, open Performance.
  2. The summary cards show Texture usage, 3D geometry, Package size, GPU impact, and FPS, each marked Good, Warning, or High.
  3. The By layer list shows what each layer costs, heaviest first.

Performance warnings never block you. They are guidance so a filter runs well on a phone before you ship it. See Check performance.

5. Export the package

  1. Press Export in the top bar.
  2. Choose an output folder.
  3. Leave the .nosmai package selected (it is always produced) and pick any preview files you want alongside it.
  4. Fill in the filter's name and other distribution details.
  5. Press Export.

Studio writes a folder named after the filter, containing the .nosmai package and the previews you chose.

Verify it worked

  • The preview showed the filter on your live camera.
  • The Beauty change updated the preview as you dragged the slider.
  • The output folder contains a .nosmai file (and your chosen previews).

Common problems

What you seeWhyFix
The preview is black after pressing playThe engine has not painted a frame yet, or camera access was deniedAllow camera access and give it a second; if it stays black, stop and start the preview again
The template will not openStudio is running in a browser, which cannot read files from diskUse the desktop app
Export is greyed outA required distribution field is empty, or no output folder is chosenChoose an output folder and fill the required fields (name, ID, author, type)
A preview video option is disabledThe preview source is a still image, which cannot make a videoChoose a camera or a video preview source to produce the mp4, webp, and gif

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