Getting Started
📦 Installation
- Import SoundGraph from the Unity Asset Store. It installs as a package (
com.glowingrifts.soundgraph) and uses theGlowingRifts.SoundGraphnamespace. - It needs
com.unity.nuget.newtonsoft-json, which Unity adds for you. - Unity 6 or newer. Runs on Windows, macOS, Linux and WebGL.
- Optional: import the examples from Package Manager > SoundGraph > Samples > Examples.
🎛️ Your First Graph
- Choose Assets > Create > GlowingRifts > SoundGraph.
- Double-click the new
.soundgraphasset. It opens in its own editor tab. - Press Space (or right-click) and add an Oscillator and an Audio Output.
- Drag from the oscillator’s output to the Audio Output’s input.
- Press ▶ Preview in the toolbar. If you hear nothing, check that the Game view’s Mute Audio is off.
Turn the knobs to shape the sound. Drag up and down, hold Shift for fine control, double-click to reset, or type a value in the box under a knob. A knob dims when a wire drives its input.
🔌 Signals
Ports are coloured by type, and a wire only joins ports that fit.
| Colour | Type | Used for |
|---|---|---|
| Orange | Mono | Sound, one channel |
| Purple | Stereo | Sound, left and right |
| Blue | CV | Control values such as frequency, time or level |
| Yellow | Gate | On and off, triggers |
| Red | Note | One note (pitch, gate, velocity) |
| Pink | Chord | Several notes, also used for scales |
Split, Merge and Transpose adapt to the wire you connect. Colours can be changed in Project Settings > GlowingRifts > SoundGraph.
🎮 Play It in a Game
Add GlowingRifts > SoundGraph Source to a GameObject, drag your .soundgraph into it and press Play. See In a Game for controlling it from code.
Note
Graphs are limited to 128 nodes and 256 wires. Small graphs of 10 to 40 nodes work best.