Open Brush Unity SDK

Using Open Brush with Unity


The Open Brush Unity SDK allows you to import your Open Brush sketches into Unity. The SDK includes:
  • All of Open Brush’s brush materials
  • An importer script that automatically assigns Open Brush materials to imported .glb files
  • Open Brush’s audio reactivity functionality that make brushes react to music


The SDK has these requirements:
  • Your project must use Unity 2017.4.22f1 or higher

Getting the code

Download the latest version of the toolkit from:
The SDK comes in the form of a Unity Package. To import:
  1. 1.
    Open Unity
  2. 2.
    Create a project or open an existing one
  3. 3.
    Double click the downloaded .unitypackage file, or go to Assets > Import Package > Custom Package.
  4. 4.
    Import the package

Importing a sketch

To use a Tilt Brush sketch inside of Unity, you need to export it and copy the exported .gltf file into your project. You do _not _need any of the .png files that come with the export. The SDK will use its own, Tilt Brush materials instead.
The SDK will process .glb files on import and assign the correct materials.
To export a sketch:
  1. 1.
    Open Tilt Brush, load your sketch
  2. 2.
    Click the [...] icon in the settings area of your hand menu
  3. 3.
    Click the **Labs **icon
  4. 4.
    Hit Export in the floating window that pops up
To import a sketch into your scene:
  1. 1.
    Copy the .glb file (in My Documents/Open Brush/Exports on Windows or Documents/Open Brush/Exports on Mac) into your Unity project
  2. 2.
    Drag the file from the Project window into the Hierarchy
  • The Open Brush Unity SDK doesn’t load .tilt files.
  • You don’t need to copy the textures included with the .glb into your project


"My brushes look different to Open Brush" (Linear vs Gamma)

For historical reasons Open Brush uses gamma mode for color blending. We may offer the option to switch to linear in the future but it will change the appearance of sketches so gamma will always be an option when the hardware allows it.
If your Unity project is set to linear mode (Projects > Player Settings) then imported sketches may look different. For example here's some smoke brush strokes in Open Brush:
And here's the same sketch in Unity set to linear mode:
The v11 toolkit shaders support both sRGB (Gamma) and Linear color spaces. The shaders are set to Gamma mode by default. If you wish to use Linear, add this call somewhere in your program.
Note: while this improves the colour accuracy, due to fundamental differences between linear and gamma rendering, brushes may still not exactly replicate the look of their gamma counterparts.

Audio Reactivity

You can make the brushes wiggle to the audio in your scene:
  1. 1.
    Drag the** [Tilt Brush Audio Reactivity] prefab** into your scene
  2. 2.
    Add an audio source to your scene, if there’s none
If the brushes aren’t moving, you can select the prefab in Play mode to visualize the audio data the shaders are receiving:


You can achieve_ an Open Brush look_ by adding Bloom, using Unity’s built-in shaders:
  1. 1.
    Import the Standard Assets “Effects” package (Assets menu / Import Package / Effects)
  2. 2.
    **Important: **Enable your camera’s HDR checkbox
  3. 3.
    Add the Bloom post-processing effect, these are recommended settings:
Internally, Open Brush uses a modified version of Sonic Ether bloom, which has been released as open source.