UUinsome

This repo contains scripts to connect Open Broadcast Studio (OBS) and PowerPoint on Windows and Mac.

Features:

• Change OBS Scenes with PowerPoint slide tags.
• Scrolling slide notes
• Use OBS Hotkeys to navigate slides

Table of Content

• Prerequisite
• Getting Started on Windows
  • Overview
  • Setup OBS
  • Setup PowerPoint
• Getting Started on MacOS
  • Overview
  • Setup OBS
  • Import Shortcuts
  • UUinsome Keynote and Powerpoint Controls
• Using UUinsome
  • Connect to OBS
  • Adding Slide Tags
  • Teleprompter Setting
  • Navigating Slides
  • Adding Notes

Prerequisite

• Open Broadcast Studio (obs)
• Windows
  • PowerPoint
• MacOS
  • Chrome browser
  • Shortcuts
  • PowerPoint or Keynote

Getting Started on Windows

Overview

Getting started video

sequenceDiagram
Participant OBS
Participant PP as PowerPoint +<br/> Script Lab
    OBS->>OBS: Start WebSocket server 
    PP ->>+OBS: Connect to OBS 
    OBS->>-PP: Scene and Camera <br/>tag options
    PP->>PP: Add tags
    PP->>PP: Navigate Presentation<br/>Next / Previous
    PP ->>+OBS: Tags and Slide Notes
    OBS->>OBS: Change Scene /<BR/> Display Notes

Loading

Setup OBS

Import the UUinsome Windows Scene Collection

In OBS

• Click Scene Collection > Import
• Choose the "UUinsome Windows Collection"
• Switch to the UUinsome Windows Collection

Start the OBS Web Socket Server.

In the OBS Tools menu, click "WebSocket Server Settings"

• Check "Enable WebSocket server"
• Click "Show Connect Info", and copy the password.

Setup PowerPoint

Install the PowerPoint add-in Script Lab

Script Lab is a free PowerPoint add-in by Microsoft.

In PowerPoint click "Add-Ins" and search for Script Lab.

Import UUinsome Script Lab script

Copy the UUinsome script from this repo UUinsome Script Lab

In PowerPoint use the "Script Lab" tab to open the code editor. CLick Import and paste the UUinsome script into the text editor.

Click the Run button to start the UUinsome script

Getting Started on MacOS

Overview

Note

In MacOS Script Lab doesn't support WebSockets. The Safari Browser and Shortcuts app is used instead of Script Lab.

sequenceDiagram
Participant OBS
Participant S as Chrome
Participant SC as Shortcuts for <br/>Mac
Participant PP as PowerPoint / <br/> Keynote
  OBS->>OBS: Start WebSocket server 
  S ->>+OBS: Connect to OBS 
  OBS->>-S: Scene and Camera <br/>tag options
  S->>SC: Add tags
  SC->>PP: Add tags
  S->>+SC: Navigate Presentation<br/>Next / Previous
  SC->>+PP: Navigate Presentation<br/>Next / Previous
  PP->>-SC: Tags and Slide Notes
  SC->>-S: Tags and Slide Notes
  S ->>OBS: Tags and Slide Notes
  OBS->>OBS:  Change Scene /<BR/> Display Notes

Loading

Setup OBS

• Import the UUinsome macOS Collection

Start the OBS Web Socket Server.

In the OBS Tools menu, click "WebSocket Server Settings"

• Check "Enable WebSocket server"
• Click "Show Connect Info", and copy the password.

Import Shortcuts

Shortcuts is an automation app included with macOS. These scripts created in Shortcuts will control changing slides in Keynote and PowerPoint. the Shortcuts will also send the slide data back to OBS.

Download the Shortcuts from this repo Apple Shortcuts

In the Shortcuts app, click File > Import...

UUinsome Keynote and Powerpoint Controls

Open the UUinsome controls page at https://uuoocl.github.io/UUinsome/

Using UUinsome

Connect to OBS

In the UUinsome controls page's "Connect to the OBS WebSocket Server" section, enter WebSocket Server IP, Port and Password.

Adding Slide Tags

After connecting to OBS, the available tags will appear on the page. Click on a tag to add it to a Keynote or Power Point presentation.

Teleprompter Setting

The Slide Notes are displayed in an OBS Text Source.
Right click on the "Slide Notes" Scene, then click "Windowed Projector (Scene)"

Use the UUinsome controls to adjust the teleprompter.

• Speed
• Size

Navigating Slides

Adding Notes

####Windows

####MacOS