Cameras & PTZ Control
OBSBOT Tail Air Control Software
OBSBOT Tail Air / Tail 2 over OSC.
Handlers run inside Fantacore — the file is a plugin, not a standalone program. Start with the free 30-day trial.
How to connect OBSBOT Tail Air to Fantacore
- Open the Fantacore Dashboard and click Add Device.
- Pick the OBSBOT Tail Air handler from the device type list (internal id
obsbot_tail_air). - Enter the IP address of your OBSBOT Tail Air, then set protocol OSC-TCP and port
57110. - Save and connect. Fantacore starts polling the device and publishes its feedback variables, ready to use in panels, sequences and logic flows.
- Drag the actions below onto a panel button, a Stream Deck key, a schedule or a logic flow node.
| Protocol | OSC-TCP |
|---|---|
| Default port | 57110 |
| Handler version | 4.1.1 |
| Author | Fantacore Bridge |
| Internal ID | obsbot_tail_air |
Description & Instruction
Features:
- Pan/tilt, zoom, focus, exposure, ISO, shutter, white balance, mirror, presets, AI tracking, recording, snapshot.
- Faders, rotaries and Stream Deck + dials for zoom, pan, tilt, focus, color temperature, exposure compensation, ISO and shutter.
- Zoom and gimbal position read back from the camera.
Command Integration Guide
This guide explains how to control and monitor an OBSBOT Tail Air or Tail 2 over OSC.
Setup
Set the device protocol to OSC-TCP, port 57110, and choose the camera model in the device settings. Over TCP the camera answers on the same connection, so the zoom and the pan/tilt position come back; over UDP it answers to port 57120 of the client and Fantacore does not listen there, so the controls work but nothing is read back.
Faders, rotaries and Stream Deck + dials
Zoom, Pan, Tilt, Manual Focus, Color Temperature, Exposure Compensation, ISO and Shutter Speed each have a (Fader, Rotary) action and a (Dial, Steps) action. The camera reports only its zoom, field of view and gimbal angles: the focus, ISO, shutter, exposure, white balance and AI mode variables hold the last value Fantacore sent.
Real-time Variables:
<device>_zoom_level,_zoom_fov,_pan_deg,_tilt_degand the positions_zoom_pos,_pan_pos,_tilt_pos: read from the camera.- Last sent:
_focus_value,_iso_value,_shutter_value,_exposure_comp,_color_temp,_ai_mode,_recording,_last_preset.
Generic Command Format (OSC):
An action id that starts with / is sent as an OSC address, followed by integer arguments:
/OBSBOT/WebCam/General/SetGimbalUp 50/OBSBOT/WebCam/General/SetZoom 70/OBSBOT/WebCam/General/SetGimMotorDegree 40 30 -10(speed, pan, tilt)
Integration Examples (assuming device name "OBSBOT_AIR"):
Via HTTP GET:
Due to the structured nature of OSC messages (address + arguments), direct HTTP GET can be complex.
Example (concept): http://<Fantacore_IP>:<HTTP_PORT>/sendTo/OBSBOT_AIR?cmd=/OBSBOT/WebCam/General/SetZoom%2070 (URL-encode the address and argument)
Via TCP/UDP Listener:
OBSBOT_AIR:/OBSBOT/WebCam/General/SetGimbalUp 50 (This relies on Fantacore parsing the string into OSC arguments).
It is generally recommended to use the UI actions for specific OBSBOT commands for easier configuration.
OBSBOT Tail Air control — frequently asked questions
Does Fantacore support OBSBOT Tail Air?
Yes. Fantacore includes a ready-made OBSBOT Tail Air handler (version 4.1.1) that talks to the device over OSC-TCP, default port 57110. It is bundled with every licence and with the 30-day free trial — there is no per-device fee.
What protocol does the OBSBOT Tail Air handler use?
OSC-TCP, default port 57110. Fantacore connects straight to the device over your production network, so no gateway, middleware or vendor software is needed in between.
Can I control OBSBOT Tail Air from a Stream Deck?
Yes. Every OBSBOT Tail Air action can be mapped to an Elgato Stream Deck key, to a button on a custom Fantacore touch panel, to a timed schedule, or to a logic flow triggered by another device — including devices from a different manufacturer.
Can I modify the OBSBOT Tail Air handler?
Yes. The handler is a plain JavaScript file (obsbot_tail_air.js) that you can download from this page, edit and drop back into Fantacore. You can also write your own handler from scratch — see the Developer Guide.
Control OBSBOT Tail Air from a single interface
Fantacore drives OBSBOT Tail Air alongside 50+ other broadcast, lighting, audio and smart home devices — from custom touch panels, an Elgato Stream Deck, a schedule or a logic flow. Runs offline.