Overview
Export produces a .nosmai package. From there the filter reaches an app in one of two ways: bundled with the app through the Nosmai SDK, or delivered at runtime through Cloud Filters. Studio itself does not publish to an app: it writes the package, and a developer or the Nosmai Console takes it on.
Product: Nosmai Studio · Platform: macOS, Windows · Updated: 6 October 2026 · Reading time: 5 minutes
The two delivery paths
- Bundled with the app. A developer adds the
.nosmaifile to their project and loads it with the Nosmai SDK. The filter ships inside the app build. - Cloud Filters. The package is hosted and delivered to the app at runtime, so a filter can be added or updated without a new app release. The app requests it by its filter ID.
Which path a filter takes is decided by the team building the app, not in Studio. Because of this split, you can design a filter without knowing in advance where it will run.
How a filter is identified
The package carries the distribution metadata you set at export: a display name, an ID, a version, an author, and a minimum SDK version. The ID is how an app and a catalogue refer to the filter. Keep the ID stable across versions of the same filter. See Distribution metadata.
Updating a filter
To release a change:
- Open the filter's project in Studio and edit it.
- Raise the version in the export dialog (for example
1.0.0to1.1.0). - Keep the same ID so the update replaces the previous version rather than creating a new filter.
- Export again and hand the new package to the same delivery path.
A filter delivered through Cloud Filters can be updated without shipping a new app build; a bundled filter updates when the app does.
Verify it worked
- The exported package carries the ID, version, author, and minimum SDK version you set.
- An updated filter keeps the same ID and a higher version than the one it replaces.
Common problems
| What you see | Why | Fix |
|---|---|---|
| An update created a second filter instead of replacing the first | The ID changed between versions | Export the update with the same ID as the original |
| A device loads an old version after an update | A bundled filter updates only with the app | Ship the update through Cloud Filters, or release a new app build |
| The app cannot run the filter | Its minimum SDK version is higher than the app's SDK | Lower the minimum SDK version, or update the app's SDK |
| The filter is not available in the app | It has not been added to a delivery path yet | A developer must bundle it or add it through the Nosmai Console |