Nosmai Studio Export a package
Nosmai Studio / Publishing / Export a package
Updated October 6, 2026

Export a filter from Nosmai Studio to produce a .nosmai package the Nosmai SDK runs, plus optional preview images and video. The export dialog always writes the .nosmai file and lets you add an mp4, an animated webp, a gif, and a poster frame. A developer or the Nosmai Console takes the package from there.

Overview

Export turns a filter into a .nosmai package, the file the Nosmai SDK runs. The export dialog always writes that package and can also produce preview media (an mp4, an animated webp, a gif, and a poster frame) and a metadata file, all in one folder named after the filter.

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

Prerequisites

  • A filter with at least one layer that has its source set (export refuses an empty media or model source).
  • An output folder you can write to.
  • For a preview video, a camera or video preview source (a still image produces only the poster frame).

Export

  1. Press Export in the top bar. The export dialog opens.
  2. Choose an output folder.
  3. Choose which files to create (see below). The .nosmai package is always on.
  4. Fill in the distribution details (see Distribution metadata).
  5. Press Export.

The export dialog with its file options and a performance card.

Files it can create

All files land in a folder named after the filter's ID:

FileWhat it is
<id>.nosmaiThe SDK package. Always produced
<id>_manifest.jsonCatalogue metadata (optional)
<id>_<video>.mp4An H.264 preview video (optional)
<id>_preview_web.webpAn animated WebP preview (optional)
<id>_preview.gifAn animated GIF preview (optional)
<id>_preview.pngA single poster frame (optional)

When the preview source is a still image, the mp4, webp, and gif are disabled and only the PNG is produced.

Export settings

  • Preview source: the current camera, bundled, or imported media. For a camera source, a bundled video is used for the export previews.
  • Preview length: 4, 6, or 10 seconds.
  • Preview quality: 720p (realtime) or High (1080p).
  • Poster frame time: where in the preview the PNG is taken.
  • Overwrite: whether to replace existing files in the folder.
  • A performance card shows the filter's verdict before you export. It is advice only and never blocks the export.

Verify it worked

  • The output folder contains a .nosmai file.
  • Any preview files you selected are in the same folder, named after the filter ID.
  • The dialog closed without an error.

Common problems

What you seeWhyFix
Export is disabledA required metadata field is empty, or no output folder is setChoose a folder and complete name, ID, author, and type
Only a PNG was producedThe preview source is a still imageUse a camera or video source for the mp4, webp, and gif
Export refused with an empty sourceA media or model layer has no fileSet the source in that layer's inspector, or remove the layer
The package will not load on a deviceA referenced asset was missing at exportCheck the Files panel, re-import the asset, and export again

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