• Guideline

A Beginner-Friendly Tutorial for Live Coding Artists

This tutorial walks you through building a real-time audiovisual interaction between Unity and Sonic Pi, using Open Sound Control to send live-coded values to a Unity 3D object. It’s perfect for beginners in audiovisual live coding and interactive installation art.

1. Setup Guide 🛠

1.1 Install Unity and extOSC Plugin

1. Install Unity Hub

   Download Unity Hub from the official website, and install the latest stable Unity version (recommended: Unity 2022 or later).

2. Create a New Project

   In Unity Hub, click “New Project” → choose the 3D (built-in renderer) template → name your project and click Create.

1. Import extOSC Plugin
   • Option A: via Unity Asset Store
     • In Unity, go to Window > Asset Store.
     • Search for extOSC (by Iam1337).
     • Click Download or Import to add it to your project.
   • Option B: via GitHub
     • Visit the extOSC GitHub repo.
     • Download the extOSC.unitypackage.
     • In Unity, go to Assets > Import Package > Custom Package... and import the file.

extOSC - Open Sound Control

1.2 Set Up extOSC in Unity

1. Create an OSC Manager
   • Right-click in the Hierarchy → choose Create Empty → name it OSCManager.
   • Select OSCManager → click Add Component → add:
     • OSC Transmitter (if you want Unity to send messages out),
     • OSC Receiver (required for this project).

1. Configure OSC Receiver
   • In the OSC Receiver component, set:
     • Local Port to 7000 (or any open port).

🔒 Make sure no other app is using the same port (like SuperCollider on 57120).

2. First Example: Controlling Sphere Color 🎨