# File formats

> A reference of the file formats Nosmai Studio imports for each layer kind, and the files it produces on export. Use it to prepare assets before you import, and to know what an export writes. The exported package is always a .nosmai file.

> For AI agents: the complete documentation index is at https://nosmai.com/llms/studio.txt

Product: Nosmai Studio
Group: studio-reference
Source: https://nosmai.com/docs/studio/reference/file-formats/



## Overview

The file formats Nosmai Studio imports for each layer kind, and the files it
produces on export. Prepare assets in these formats before importing.

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

## Import formats

| Use | Formats |
| --- | --- |
| Image or overlay | `png`, `jpg`, `jpeg`, `webp` |
| Media (image or video) | `png`, `jpg`, `jpeg`, `webp`, `gif`, `mp4`, `mov`, `webm` |
| 3D model | `glb`, `gltf`, `vrm` |
| Colour LUT | `cube`, `png` |
| Audio | `mp3`, `wav`, `m4a`, `aac`, `ogg` |
| Font (for text) | `ttf`, `otf` |

You can import by choosing a file in a layer's inspector, through the add-a-layer
sheet, or by dragging a file onto the editor.

## Export files

Export writes a folder named after the filter's ID, containing:

| File | What it is | Optional |
| --- | --- | --- |
| `<id>.nosmai` | The SDK package | Always produced |
| `<id>_manifest.json` | Catalogue metadata | Yes |
| `<id>_<video>.mp4` | H.264 preview video | Yes |
| `<id>_preview_web.webp` | Animated WebP preview | Yes |
| `<id>_preview.gif` | Animated GIF preview | Yes |
| `<id>_preview.png` | Poster frame | Yes |

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

## Notes

- The `.nosmai` package is the only file the Nosmai SDK runs. The previews are for
  catalogues and listings.
- A sequence asset ships as its individual frames inside the package, so its on-disk
  size is the sum of its frames.

## Next steps

- [Add a layer](/docs/studio/guides/add-a-layer/)
- [Export a package](/docs/studio/publishing/export-a-package/)
- [Limits and technical guidelines](/docs/studio/reference/limits/)

## Reference

- [Layer kinds](/docs/studio/reference/layer-kinds/)
- [Glossary](/docs/studio/reference/glossary/)
