Advanced OSC Integration with TouchOSC, QLab, and More

Message Format

• Messages are sent as OSC bundles
• All strings are UTF-8 encoded
• Sent immediately when a new song is detected
• /song/changed fires with every detection (useful for triggers)

Translate accordingly.

Step 1: Configure OSC in Song Overlays Pro

Set up the OSC output for your target application.

1. Open Song Overlays Pro
2. Click OSC in the sidebar
3. Toggle Enable OSC to on
4. Configure connection settings:
   • Host: Target device IP (or 127.0.0.1 for same machine)
   • Port: Match your receiving application's port
5. Click Test to verify connectivity

Translate.

Multiple Destinations

Send to multiple applications simultaneously:

1. Click Add Destination
2. Enter additional host/port combinations
3. Each destination receives identical data
4. Useful for redundancy or multi-system setups

Translate.

Step 2: TouchOSC Integration

Build a custom control surface that displays song information.

Setting Up TouchOSC

1. Open TouchOSC on your iPad/iPhone/Android
2. Go to Connections → OSC
3. Configure to receive from your Mac:
   • Receive Port: Match Song Overlays Pro's output port
   • Send Host/Port: Your Mac's IP and desired port (for bidirectional)

Translate.

Creating a Song Display Layout

1. Open TouchOSC Editor (desktop app)
2. Create a new layout
3. Add Label controls for song data:
   • Label for title: Set OSC address to /song/title
   • Label for artist: Set OSC address to /song/artist
   • Label for album: Set OSC address to /song/album

Translate.

Label Configuration

For each label:

• Receive: Enable
• OSC Address: Corresponding /song/... address
• Value: Text (receives string)
• Font/Size: Style as desired

Translate.

Advanced TouchOSC Ideas

Now Playing Panel:

┌─────────────────────────┐
│  🎵 NOW PLAYING         │
│  ─────────────────────  │
│  Title: {/song/title}   │
│  Artist: {/song/artist} │
│  Album: {/song/album}   │
└─────────────────────────┘

DJ Controller Integration:

• Add song display to existing DJ layouts
• Combine with mixer controls
• Create set management views

Translate.

Step 3: QLab Integration

Trigger cues in theater productions based on songs.

Configuring QLab for OSC

1. Open QLab (version 4 or 5)
2. Go to Settings → Network
3. Under OSC Input:
   • Enable OSC input
   • Set port to match Song Overlays Pro's output
   • Note QLab's IP if on different machine

Translate.

Creating Song-Triggered Cues

Method 1: OSC Trigger Cues

1. Create a new OSC cue
2. Set as trigger cue (responds to incoming OSC)
3. Configure the trigger:
   • Address: /song/changed
   • Arguments: (any value triggers)

Method 2: Script Cues

For more control, use AppleScript:

-- This script runs when song changes
tell application id "com.figure53.QLab.5"
    set songTitle to (osc value "/song/title")
    -- Use songTitle to control cues
end tell

Translate. Keep code block unchanged.

Theater Use Cases

Musical Transitions:

• Auto-advance cues when songs change
• Sync lighting with music changes
• Trigger scene markers

Immersive Experiences:

• Display song info on projection
• Trigger effects based on specific songs
• Create dynamic setlists

Example: Auto-Advance Playlist

1. Create a group cue for each song
2. Add OSC trigger that fires when /song/changed is received
3. Use conditions to match /song/title to expected song
4. Auto-fire the next cue group

Translate.

Step 4: Isadora Integration

Create interactive visuals that respond to music metadata.

Setting Up Isadora

1. Open Isadora
2. Go to Communications → OSC Setup
3. Enable OSC Input on a specific port
4. Match port in Song Overlays Pro

Translate.

Basic Song Display Patch

1. Add OSC Listener actor? Actually code: OSC Listener actor. We'll keep same.
2. Set address to /song/title
3. Connect to Text Draw actor
4. Route to output stage

[OSC Listener] → [Text Draw] → [Projector]
    /song/title     font/size      stage 1

[OSC Listener] → [Picture Player] → [Projector]
   /song/artwork      URL input        stage 1