OSC io

Drive OBS events with Open Sound Control (OSC) messages.

Setup

Install Python

Python is a programming language that will need to be installed for the Keynote Controls to work.

OBS supports python version 3.11 . It's important that Python 3.11 is installed. Newer versions are available, but these newer versions will not work.

Note
  1. Download the MacOS installer
  2. Install Python 3.11 to the default location

Install Python dependencies

This script use the Python OSC Library

  1. Open the Terminal app
  2. Enter the pip command
python3.11 -m pip install python-osc

Configure OBS Python Settings

OBS needs to know where Python is installed. Use the macOS Terminal app to find the Python install path. Then enter the Python install path in OBS

  1. Open the Terminal app
  2. Enter the 'which' command
which python3.11

The default install path will be returned

/Library/Frameworks/Python.framework/Versions/3.11/bin/python3.11
  1. Use the mouse to highlight the path

  2. Right click and select "Copy"

  3. Open OBS

  4. From the menu bar select Tools > Scripts

  5. In the Scripts window switch to the Python Settings tab

  6. Click the "Browse" button

  7. Use the keyboard shortcut cmd + shift + G

  8. In the pop-up, right click in the "Go To Folder" input field

  9. select paste
    Pasted image 20251106140904.png

  10. Press "Enter"

  11. Click the "Open" button
    The Pythons settings should now display "Loaded Python Version: 3.11"
    Pasted image 20251106141241.png

Add the Keynote Controls Script to OBS

The "Keynote Controls" script and accompanying OBS Collection can be found on Github.

Import the Keynote Controls OBS Collection

  1. Download the Keynote Controls Collection
  2. In OBS, from the menu select Scene Collection > Import
  3. Import the collection
  4. Choose the collection Scene Collection

Add the Keynote Controls Script

  1. Download the Keynote Controls Script
  2. In OBS, from the menu select Tools > Scripts
  3. Click the + Add script button

After installing the script, adjust the settings to the camera and slides scene.

The "Slides" scene includes a "macOS Screen Capture" source to capture the Keynote slides. You can set the 'Display' as needed.

2025-11-06_14-46-18.png

Using "Keynote Controls"

Add Scene tags to slides

Adjust teleprompter

[[
]]

Configure Remote Controlller