# Install and sign in

> Install Nosmai Studio on macOS or Windows and sign in with your Nosmai account. Studio needs a signed-in account with a Studio entitlement to open the editor. Signing in also fetches the licence the preview engine checks, so the live preview works offline afterwards.

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

Product: Nosmai Studio
Group: studio-get-started
Source: https://nosmai.com/docs/studio/get-started/install-and-sign-in/



## Overview

Nosmai Studio runs as a desktop app on macOS and Windows. The editor is behind a
sign-in screen: you need a Nosmai account with a Studio entitlement to open it.
Signing in also acquires the licence the preview engine verifies, so the live
preview keeps working offline after the first successful sign-in.

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

## Prerequisites

- A Nosmai account. You can create one from the sign-in screen.
- A Studio entitlement on that account. Without it, sign-in succeeds but the
  editor stays closed.
- A working camera for the live preview.

## Install Studio

1. Download the Nosmai Studio installer for your platform.
2. Open the installer and move the app into Applications (macOS) or run the setup
   (Windows).
3. Launch Nosmai Studio.

On a locally built copy, macOS may warn that the app is from an unidentified
developer. That is the Gatekeeper quarantine on an unsigned local build, not a
problem with the app.

## Sign in

The sign-in screen offers three ways in:

1. **Email and password.** Enter your account email and password. If your account
   has two-factor authentication, Studio asks for the 2FA code next.
2. **Google.** Sign in through Google in a system browser window, then return to
   Studio.
3. **GitHub.** Sign in through GitHub the same way.

To make an account instead, switch the control at the top of the card to
**Create an account**, then enter an email and a password. A strength meter shows
how strong the password is.

"Remember me" keeps you signed in on this machine between launches.

## What sign-in does

- Your account token is held only by the app's background process and encrypted
  at rest in the operating system keychain. The editor never sees the raw token.
- Studio reads your account and its Studio entitlement from the Nosmai Console
  service, then acquires a short-lived licence token the preview engine verifies.
- Because that licence is cached, the live preview continues to work without a
  network connection until the licence needs refreshing.

## Verify it worked

- The editor opens (or the home screen, if no project is open).
- The home screen shows your account name or email, with a **Logout** control.
- Starting the preview on a filter renders a live image rather than an error.

## Common problems

| 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 sign-in screen never 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 only apply there |
| The preview shows a licence error after being offline a long time | The cached licence needs refreshing | Reconnect to the network once and start the preview again |
| Google or GitHub sign-in does not return to Studio | The system browser window was closed before finishing | Start the OAuth sign-in again and complete it in the browser |

## Next steps

- [Make your first filter](/docs/studio/get-started/make-your-first-filter/)
- [Tour the editor](/docs/studio/interface/the-editor/)
- [The home screen](/docs/studio/interface/home/)
- [Support and troubleshooting](/docs/studio/support/)

## Reference

- [Introduction to Nosmai Studio](/docs/studio/get-started/introduction/)
