Getting Started

Getting Started

📦 Installation

  1. Import SoundGraph from the Unity Asset Store. It installs as a package (com.glowingrifts.soundgraph) and uses the GlowingRifts.SoundGraph namespace.
  2. It needs com.unity.nuget.newtonsoft-json, which Unity adds for you.
  3. Unity 6 or newer. Runs on Windows, macOS, Linux and WebGL.
  4. Optional: import the examples from Package Manager > SoundGraph > Samples > Examples.

🎛️ Your First Graph

  1. Choose Assets > Create > GlowingRifts > SoundGraph.
  2. Double-click the new .soundgraph asset. It opens in its own editor tab.
  3. Press Space (or right-click) and add an Oscillator and an Audio Output.
  4. Drag from the oscillator’s output to the Audio Output’s input.
  5. 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.

ColourTypeUsed for
OrangeMonoSound, one channel
PurpleStereoSound, left and right
BlueCVControl values such as frequency, time or level
YellowGateOn and off, triggers
RedNoteOne note (pitch, gate, velocity)
PinkChordSeveral 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.