Nosmai Studio Add a layer
Nosmai Studio / Guides / Add a layer
Updated October 6, 2026

Add a layer in Nosmai Studio to build up a filter: a face or hand attachment, text, beauty, a background, a colour grade, a shader, audio, or a 3D model. Open the add-a-layer sheet from the + in the Layers panel, pick a kind, and set its properties in the inspector. A filter can mix as many layers as you like.

Overview

A filter in Nosmai Studio is built from layers. This page covers how to add one, the kinds available, and what asset each kind takes. Open the add-a-layer sheet from the + in the Layers panel, pick a kind, and set its properties in the inspector.

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

Prerequisites

  • A project open in the editor.
  • For a Script layer, Everything mode (see Modes and views).

Add a layer

  1. In the Layers panel, press the + at the top. The add-a-layer sheet opens.
  2. Pick a layer kind. The kinds are grouped by where they draw.
  3. For a layer that takes a file (an image, a model, a LUT, audio), choose the file, or add the layer empty and choose the source later in its inspector.
  4. The new layer appears in the Layers list. Select it to open its inspector.

The add-a-layer sheet, grouped by where each layer draws.

The layer kinds

Behind you (background):

  • Background blur, background image, background video, or a background shader (advanced).

The whole picture (colour):

  • Colour LUT (a .cube file or a hand grade), a full-frame effect (grain, glow, vignette), or a shader that runs before 3D (advanced).

On top (overlay and text):

  • Image overlay, video overlay, Text, a Text layer group (holds several pieces such as a score and a timer), or a shader that runs after 3D (advanced).

On a face or hand:

  • 3D model layer (a GLB pinned to a face or a hand; picking it asks whether it goes on a face or a hand), Face mask (artwork on the skin), Hand surface, a Face mask shader (advanced), Beauty (skin, makeup, lenses, reshape), and Hair (recolour, hide, or shade).

Sound:

  • Audio: a sound that plays with the filter.

Advanced:

  • Runtime parameter (a value the host app can set while the filter runs) and Script (Lua, in Everything mode only).

What each kind takes

KindFile formats
Image or overlaypng, jpg, jpeg, webp
Media (image or video)png, jpg, jpeg, webp, gif, mp4, mov, webm
3D modelglb, gltf, vrm
Colour LUTcube, png
Audiomp3, wav, m4a, aac, ogg
Font (for text)ttf, otf

You can also drag a file onto the editor to import it.

Verify it worked

  • The new layer appears in the Layers list, in the group for its kind.
  • Selecting it opens its inspector below the list.
  • If the layer takes a file and you added it empty, the inspector shows a Choose or Replace control for the source.

Common problems

What you seeWhyFix
The Script row is disabledScripts need Everything modeSwitch to Everything in the top bar
Export refuses with an empty sourceA media or model layer has no file chosenChoose a file in the layer's inspector, or remove the empty layer
A dropped file did nothingThe format is not supported for any layerConvert it to a supported format from the table above
The layer does not appear in the previewIt needs a face or hand that is not in view, or it is hiddenShow a face or hand, and check the layer's eye toggle

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