# Add reactions and gestures

> Make a filter respond to a face gesture in Nosmai Studio by adding a reaction: a blink, a wink, or the face appearing or leaving can reveal a material, play an animation, show a layer, or drive a shader. Reactions are configured in the Reactions strip under the stage and are how two of the three shipped templates come to life.

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

Product: Nosmai Studio
Group: studio-guides
Source: https://nosmai.com/docs/studio/guides/reactions-and-gestures/



## Overview

A reaction makes something in a filter respond to a face gesture: a blink reveals a
material, a long blink plays an animation, the face leaving hides a layer. You set
reactions up in the **Reactions** strip under the stage. They are the interactivity
behind the Loki Magic (long-blink reveal) and BlinkFlyer (blink to play) templates.

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

## Prerequisites

- A filter open in the editor, with something to react (a 3D model, a layer, or a
  shader pass).
- To see a reaction fire, a device preview or a running preview with a face.

## Add a reaction

1. Open the **Reactions** strip under the stage, or press **Add reaction**.
2. Choose what reacts: an object's material, a layer's visibility or opacity, an
   animation, a sequence, or a shader pass uniform.
3. Choose the gesture that triggers it.
4. The reaction appears in the Reactions strip, listed on the thing it belongs to.

## The gestures you can use

A reaction fires on a face gesture or state. The signals the SDK feeds today:

| Gesture | What it means |
| --- | --- |
| Blink (left or right) | An eye closes. Used alone or combined |
| Long blink | Both eyes held shut briefly |
| Wink | One eye closes while the other stays open |
| Face found | A face enters the view |
| Face lost | The face leaves the view |

Some head-pose signals (face scale, head yaw, pitch, roll) are recognised by the
SDK but not yet fed with live values, so a reaction bound to one of them does not
fire. Studio marks those so you do not pick an inert trigger. Blink, wink, and the
face found and lost events are the reliable ones.

## What a reaction can do

The action a gesture triggers depends on what it is attached to:

| Attached to | The reaction can |
| --- | --- |
| A 3D model's material | Reveal, hide, or toggle the material |
| A layer | Show or hide it, or change its opacity |
| An animation | Play it |
| A sequence | Advance or control playback |
| A shader pass uniform | Drive a float the pass declares, so the shader reacts |

A shader reaction only works if the pass declares the float uniform the trigger
writes to. If it does not, the SDK drops the trigger and the pass still renders, it
just never reacts. Declare the uniform in the shader to fix it.

## Test it

Most gestures are easiest to confirm on a device, where a real face drives them.
See [Preview on a device](/docs/studio/guides/preview-on-a-device/). In the running
Studio preview, a gesture on the previewed face fires the reaction too.

## Verify it worked

- The reaction is listed in the Reactions strip, on the object it belongs to.
- Performing the gesture (for example a blink) fires the reaction in the preview.
- A shader reaction changes the pass only when the pass declares the bound uniform.

## Common problems

| What you see | Why | Fix |
| --- | --- | --- |
| The reaction never fires | It is bound to an unplumbed head-pose signal | Use blink, wink, face found, or face lost instead |
| A shader reaction does nothing | The pass does not declare the bound float uniform | Add the uniform to the shader so the trigger has something to write |
| The gesture fires unreliably | Blink and wink detection need a clear, well-lit face | Improve lighting and face the camera directly |
| Nothing reacts in Studio | The gesture needs a face in the preview | Run the preview with a face, or test on a device |

## Next steps

- [Add a 3D model](/docs/studio/guides/add-a-3d-model/)
- [Preview on a device](/docs/studio/guides/preview-on-a-device/)
- [Build a blink game](/docs/studio/tutorials/build-a-blink-game/)

## Reference

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