# Colour and LUTs

> Add a colour layer in Nosmai Studio to grade the whole frame with a .cube LUT or a full-frame effect. A LUT gives a filter a film look or a branded colour in one step; a full-frame effect adds grain, glow, or a vignette. Colour layers apply over everything the camera sees.

> 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/colour-and-luts/



## Overview

A colour layer grades the whole frame. A **Colour LUT** applies a `.cube` lookup
table (a film look or a branded colour); a **full-frame effect** adds grain, glow,
or a vignette. Both apply over the whole picture.

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

## Prerequisites

- A project open in the editor.
- For a LUT, a `.cube` file (or a LUT image).

## Add a colour LUT

1. In the Layers panel, press **+**, then choose **Colour LUT** under
   **The whole picture**.
2. Pick the `.cube` file, or add the layer and choose it in the inspector.
3. Select the layer to open its inspector.

## Set it up

The LUT inspector has:

- **Table**: the `.cube` file in use.
- **Strength**: how strongly the LUT applies, `0.0` to `1.0`. Lower it for a subtle
  grade.
- **On**: turn the LUT on or off.

A LUT attached as a chain pass also has an **Applies to** control (which regions it
affects) and runs after the 3D stage.

## Full-frame effects

A **full-frame effect** adds grain, glow, or a vignette over the frame. Add it the
same way, under **The whole picture**.

## What is planned

Brightness, contrast, warmth, a colour-punch control, and a built-in preset library
are planned and are shown as not yet available. For now, grade with a `.cube` LUT
and its strength.

## Verify it worked

- The whole frame takes on the LUT's colour in the preview.
- Lowering the strength blends the graded look back toward the original.
- Turning the layer off restores the ungraded frame.

## Common problems

| What you see | Why | Fix |
| --- | --- | --- |
| The grade is too strong | Strength is at or near `1.0` | Lower the strength until it looks right |
| The LUT did not load | The file is not a valid `.cube` or LUT image | Re-export the LUT as a standard `.cube` and re-import |
| Brightness or contrast controls are missing | Those are planned and not in this version | Grade with the LUT's strength, or bake the adjustment into the LUT |
| The "Applies to" list is disabled | The filter has no segmentation for region masking | Add a background layer, which provides segmentation, or apply the LUT to the whole frame |

## Next steps

- [Change the background](/docs/studio/guides/change-the-background/)
- [Add a script or shader](/docs/studio/guides/scripting/)
- [Add a layer](/docs/studio/guides/add-a-layer/)

## Reference

- [File formats](/docs/studio/reference/file-formats/)
