Cameras & PTZ Control
OBSBOT Tail Air Control Software
OBSBOT Tail Air / Tail 2 over OSC.
Handlers run inside Fantago — the file is a plugin, not a standalone program. Start with the free 60-day trial.
How to connect OBSBOT Tail Air to Fantago
- Open the Fantago 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. Fantago 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.0 |
| Author | Fantago 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 Fantago 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 Fantago 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://<FantaGo_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 Fantago 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 Fantago support OBSBOT Tail Air?
Yes. Fantago includes a ready-made OBSBOT Tail Air handler (version 4.1.0) that talks to the device over OSC-TCP, default port 57110. It is bundled with every licence and with the 60-day free trial — there is no per-device fee.
What protocol does the OBSBOT Tail Air handler use?
OSC-TCP, default port 57110. Fantago 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 Fantago 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 Fantago. You can also write your own handler from scratch — see the Developer Guide.
Control OBSBOT Tail Air from a single interface
Fantago 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. One-time licence, no subscription, runs offline.