Overview
When you export, Nosmai Studio asks for the metadata that identifies the filter. These details travel with the package so a developer, or a catalogue, can identify and version it. Required fields must be filled before export is allowed.
Product: Nosmai Studio · Platform: macOS, Windows · Updated: 6 October 2026 · Reading time: 5 minutes
The fields

| Field | Required | Rules |
|---|---|---|
| Display name | Yes | The filter's shown name |
| ID | Yes | A slug, derived from the name. Names the output folder and files |
| Description | No | A short description |
| Filter type | Yes | What kind of filter this is |
| Tags | No | Keywords for a catalogue |
| Version | Yes | Semantic version (for example 1.0.0) |
| Author | Yes | Who made it |
| Minimum SDK version | Yes | The lowest Nosmai SDK version that can run it. Default 3.0.0 |
| Created | Yes | A valid date |
Defaults are pulled from the filter's manifest and any stored distribution details, so re-exporting the same filter keeps its identity.
Validation
Export checks the metadata before it runs:
- Display name, ID, author, and filter type must be present.
- Version and minimum SDK version must be valid semantic versions.
- Created must be a valid date.
If any check fails, the Export button stays disabled and names the field to fix.
Verify it worked
- The output files are named after the ID.
- The exported manifest carries the name, version, author, and minimum SDK version.
- Re-exporting keeps the same ID and increments nothing automatically (you set the version).
Common problems
| What you see | Why | Fix |
|---|---|---|
| Export is disabled | A required field is empty | Fill display name, ID, author, filter type, version, minimum SDK, and created |
| Export rejects the version | It is not a valid semantic version | Use a form like 1.0.0 |
| The ID is not what you typed | The ID is a slug of the name | Edit the ID field directly if you need a specific slug |
| A device will not load the filter | Its minimum SDK version is higher than the device's SDK | Lower the minimum SDK version, or update the app's SDK |