Nosmai Studio Support and troubleshooting
Nosmai Studio / Support / Support and troubleshooting
Updated October 6, 2026

Fixes for the problems people hit most in Nosmai Studio: sign-in and entitlement failures, a black or empty preview, export that will not run, and effects that do not appear. Each entry says what you see, why it happens, and the fix. If a problem is not here, contact Nosmai support.

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 seeWhyFix
Sign-in succeeds but the editor will not openThe account has no Studio entitlementContact Nosmai to add a Studio entitlement to the account
The preview shows a licence error after a long time offlineThe cached licence needs refreshingReconnect to the network once and start the preview again
Google or GitHub sign-in never returns to StudioThe browser window was closed before finishingStart the sign-in again and complete it in the browser
No sign-in screen appears, the app goes straight inYou are running Studio in a plain browser, not the desktop appUse the desktop app; accounts and licences apply there

See Install and sign in.

The preview

What you seeWhyFix
The preview is black after pressing playNo frame has been painted yet, or camera access was deniedAllow camera access, wait a second, then stop and start the preview
The preview is empty and shows no effectThe stage is on the 3D view and the filter has no 3D contentSwitch the stage to the Preview view
Camera names are blank in the source pickerCamera access has not been granted yetAllow the camera once; the real names appear after
The filter looks right on one shape and wrong on anotherIt was authored against a single aspectUse the target aspect control and the safe-area overlay to check each shape

See Preview your filter.

Effects that do not appear

What you seeWhyFix
Beauty or a face attachment is invisibleNo face is detectedShow a face to the camera; tracked content appears only on a face
Game text does not showA script writes a text slot with no matching text layerIn the Code panel, create the missing text layers for the detected slots
A control changed the preview but not a deviceIt is a preview-only control, not written to the packageUse a control that ships; see the labels in the inspector
A model sits in front of the face when it should be behindFace occlusion is offTurn on face occlusion in the model object inspector

Export

What you seeWhyFix
Export is disabledA required metadata field is empty, or no output folder is setChoose an output folder and fill 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 file chosenSet the source in that layer's inspector, or remove the layer
An update created a second filterThe ID changed between versionsExport the update with the same ID

See Export a package.

Performance

What you seeWhyFix
A filter is marked HighA resource is over the mobile thresholdFollow 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 runningStart the preview, then open the Performance view
The frame rate drops as beauty smoothing risesSkin smoothing is the most expensive beauty stageLower 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.

Next steps

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