Overview
The problems people hit most in Nosmai Studio, with the fix for each. Start with the section that matches what you see. Every guide page also has its own Common problems table for issues specific to that feature.
Product: Nosmai Studio · Platform: macOS, Windows · Updated: 6 October 2026 · Reading time: 8 minutes
Sign-in and the account
| What you see | Why | Fix |
|---|---|---|
| Sign-in succeeds but the editor will not open | The account has no Studio entitlement | Contact Nosmai to add a Studio entitlement to the account |
| The preview shows a licence error after a long time offline | The cached licence needs refreshing | Reconnect to the network once and start the preview again |
| Google or GitHub sign-in never returns to Studio | The browser window was closed before finishing | Start the sign-in again and complete it in the browser |
| No sign-in screen appears, the app goes straight in | You are running Studio in a plain browser, not the desktop app | Use the desktop app; accounts and licences apply there |
See Install and sign in.
The preview
| What you see | Why | Fix |
|---|---|---|
| The preview is black after pressing play | No frame has been painted yet, or camera access was denied | Allow camera access, wait a second, then stop and start the preview |
| The preview is empty and shows no effect | The stage is on the 3D view and the filter has no 3D content | Switch the stage to the Preview view |
| Camera names are blank in the source picker | Camera access has not been granted yet | Allow the camera once; the real names appear after |
| The filter looks right on one shape and wrong on another | It was authored against a single aspect | Use the target aspect control and the safe-area overlay to check each shape |
See Preview your filter.
Effects that do not appear
| What you see | Why | Fix |
|---|---|---|
| Beauty or a face attachment is invisible | No face is detected | Show a face to the camera; tracked content appears only on a face |
| Game text does not show | A script writes a text slot with no matching text layer | In the Code panel, create the missing text layers for the detected slots |
| A control changed the preview but not a device | It is a preview-only control, not written to the package | Use a control that ships; see the labels in the inspector |
| A model sits in front of the face when it should be behind | Face occlusion is off | Turn on face occlusion in the model object inspector |
Export
| What you see | Why | Fix |
|---|---|---|
| Export is disabled | A required metadata field is empty, or no output folder is set | Choose an output folder and fill name, ID, author, and type |
| Only a PNG was produced | The preview source is a still image | Use a camera or video source for the mp4, webp, and gif |
| Export refused with an empty source | A media or model layer has no file chosen | Set the source in that layer's inspector, or remove the layer |
| An update created a second filter | The ID changed between versions | Export the update with the same ID |
See Export a package.
Performance
| What you see | Why | Fix |
|---|---|---|
| A filter is marked High | A resource is over the mobile threshold | Follow the "Try" suggestion for that resource; export still works |
| GPU and FPS say "Run the preview to measure" | They are measured and the preview is not running | Start the preview, then open the Performance view |
| The frame rate drops as beauty smoothing rises | Skin smoothing is the most expensive beauty stage | Lower smoothing and recheck the Performance view |
See Check performance.
Still stuck
- Check the current limitations and roadmap in case the control is preview-only or not yet built.
- Read the glossary if a term is unfamiliar.
- Contact Nosmai support with your filter, the steps that led to the problem, and the exact message you saw.