obsbot-osc
OBSBOT OSC
This module will communicate with OBSBOT products over OSC.
The OBSBOT OSC standard protocol is based on the touchOSC protocol. It can be applied to the OBSBOT Center App (software), OBSBOT Tail 2 (hardware), and OBSBOT Tail Air (hardware). The OSC application on OBSBOT Center is compatible with the OBSBOT Tiny series (Tiny, Tiny 4K, Tiny 2, Tiny 2 Lite, Tiny SE), OBSBOT Meet series (Meet, Meet 4K, Meet 2, Meet SE), and OBSBOT Tail series (Tail Air, Tail 2). However, when using the OSC protocol with OBSBOT Center, the software must be running and have the OSC server enabled.
Additionally, the OSC can be independently applied to OBSBOT Tail 2, and OBSBOT Tail Air.
Please file any issues you have with the connection on the Github repo here
Getting started
There are two ways to connect to your OBSBOT camera:
- Connecting directly via IP to the Tail 2 or Tail Air
- Connecting via OSC to the OBSBOT Center app (Tail 2, Tail Air, Tiny, Tiny 4K, Tiny 2, Tiny 2 Lite, Tiny SE, Meet, Meet 4K, Meet SE)
Direct connection
In order to connect directly to the Tail 2 or Tail Air, find the IP of the device in the OBSBOT Center app and enter it into the Device IP Address field in the configuration for the OBSBOT connection. You can leave the ports at the default.
OBSBOT Center Connection
If you wish to connect to the Tiny series or Meet series of OBSBOT cameras you will need to run the OBSBOT Center app on your computer and enable the OSC server. After enabling the OSC server, update the port and IP in the OBSBOT connection config to match the Receive Port set in the OBSBOT Center app
Configuration
- Device IP Address and Port
- Enable Verbose Logging
Actions
- Center App | Meet Series | Set Auto Framing
- Center App | Meet Series | Set to Standard Mode
- Center App | Meet Series | Set Virtual Background
- Center App | Set Focus Mode
- Center App | Set View
- Center App | Start PC Recording
- Center App | Stop PC Recording
- Center App | Take PC Snapshot
- Center App | Tail 2 | Set Pan Axis Lock
- Center App | Tail 2 | Set Pan Tracking Speed
- Center App | Tail 2 | Set Tilt Axis Lock
- Center App | Tail 2 | Set Tilt Tracking Speed
- Center App | Tail Series | AI Mode
- Center App | Tail Series | Set Tracking Speed
- Center App | Tail Series | Start Recording
- Center App | Tail Series | Stop Recording
- Center App | Tail Series | Take Snapshot
- Center App | Tail Series | Trigger Preset
- Center App | Tiny Series | AI Lock On/Off
- Center App | Tiny Series | AI Mode
- Center App | Tiny Series | Set Tracking Mode
- Center App | Tiny Series | Trigger Preset
- Gimbal | Move Down
- Gimbal | Move Left
- Gimbal | Move Right
- Gimbal | Move Up
- Gimbal | Reset Position
- Gimbal | Set Motor Degree
- Gimbal | Stop Moving Down
- Gimbal | Stop Moving Left
- Gimbal | Stop Moving Right
- Gimbal | Stop Moving Up
- Image | Set Auto Exposure On/Off
- Image | Set Auto Focus On/Off
- Image | Set Auto White Balance On/Off
- Image | Set Color Temperature
- Image | Set Exposure Compensate Value
- Image | Set ISO
- Image | Set Manual Focus Value
- Image | Set Shutter Speed
- Other | Set Mirror Mode
- Tail 2 | Set AI Mode and Auto Zoom Mode
- Tail 2 | Set Only Me On/Off
- Tail 2 | Set Tracking Speed
- Tail 2 | Start Recording
- Tail 2 | Stop Recording
- Tail 2 | Take Snapshot
- Tail 2 | Trigger Preset
- Tail Air | Set AI Mode
- Tail Air | Set Tracking Speed
- Tail Air | Start Recording
- Tail Air | Stop Recording
- Tail Air | Take Snapshot
- Tail Air | Trigger Preset
- Zoom | Set Zoom Level
- Zoom | Set Zoom Max
- Zoom | Set Zoom Min
- Zoom | Set Zoom Speed
Feedbacks
Variables
- Device Name
Presets
- Center App | Meet Series | Auto Framing Toggle
- Center App | Meet Series | Standard Mode
- Center App | Set Focus Mode
- Center App | Set View
- Center App | Recording Controls
- Center App | Take Snapshot
- Center App | Tail Series | AI Mode Controls
- Center App | Tail Series | Tracking Speed Controls
- Center App | Tail Series | Recording Controls
- Center App | Tail Series | Preset Positions
- Center App | Tiny Series | AI Controls
- Center App | Tiny Series | Tracking Mode
- Center App | Tiny Series | Preset Positions
- Gimbal | Movement Controls
- Gimbal | Position Reset
- Gimbal | Motor Position
- Image | Auto Exposure Toggle
- Image | Auto Focus Toggle
- Image | Auto White Balance Toggle
- Image | Color Temperature
- Image | Exposure Controls
- Image | Focus Control
- Tail 2 | AI Mode Controls
- Tail 2 | Tracking Controls
- Tail 2 | Recording Controls
- Tail 2 | Preset Position 1
- Tail 2 | Preset Position 2
- Tail 2 | Preset Position 3
- Tail Air | AI Mode Controls
- Tail Air | Tracking Controls
- Tail Air | Recording Controls
- Tail Air | Preset Position 1
- Tail Air | Preset Position 2
- Tail Air | Preset Position 3
- Zoom | Level Control
- Zoom | Min/Max Settings
- Zoom | Speed Control
OBSBOT
To file a new issue, you need to sign up for a user on GitHub.
Go to GitHub issues →