Recorders, Players & Encoders
Blackmagic HyperDeck Control Software
Handler for Blackmagic HyperDeck recorders and players (HyperDeck Ethernet Protocol).
Handlers run inside Fantago — the file is a plugin, not a standalone program. Start with the free 60-day trial.
How to connect Blackmagic HyperDeck to Fantago
- Open the Fantago Dashboard and click Add Device.
- Pick the Blackmagic HyperDeck handler from the device type list (internal id
bmd_hyperdeck). - Enter the IP address of your Blackmagic HyperDeck, then set protocol TCP and port
9993. - 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 | TCP |
|---|---|
| Default port | 9993 |
| Handler version | 2.0.3 |
| Author | Fantago Bridge |
| Internal ID | bmd_hyperdeck |
Description & Instruction
Features:
- Transport: play (speed, loop, single clip), stop, record (named), preview/output, go to clip / timecode / timeline, next and previous clip.
- Jog and shuttle on panel faders, rotaries and Stream Deck + dials.
- Play range, stop mode, slots, spill, remote control, inputs and file format, the timeline.
- Real-time transport, slot, configuration and device variables; the connection comes back by itself after the deck restarts.
Command Integration Guide
This guide explains how to control and monitor a Blackmagic HyperDeck. Enable Connection is Persistent: the deck is read in real time over one connection.
Jog and shuttle
Jog (Dial, Frames) is the jog wheel: each click of a Stream Deck + dial, or each step of a panel rotary in Steps mode, moves the playhead by that many frames (jog: timecode: +00:00:00:01). Set the control's Step size to the frames a click should move (1 for frame by frame, 5 or 10 to wind faster).
Shuttle Speed (Fader, Rotary) is the shuttle lever: the middle is at rest, the ends are the top speed (800 % unless you set another) and the speed grows with the square of the distance from the middle, so slow speeds have room; 100 % is about a third of the way out. The lever follows the deck: press Play and it moves to 100 %, stop and it returns to the middle. Shuttle Speed (Dial, Steps) is for a Stream Deck + dial: every click goes one rung up or down the ladder 10, 25, 50, 100, 200, 400, 800 % (leave the Step size at 1: it counts rungs). On a panel rotary use Shuttle Speed (Fader, Rotary): the knob there is drawn by the hand, which does not match a ladder.
Timeline Position (Fader) is a scrub bar over the whole timeline; turn on Live timecode and playhead in the device settings and it follows the playback. It spans the clips on the timeline (their total length), not the disk: 50 is the middle of the material, whatever the disk's size.
Real-time Variables:
Look for these in the _system_variables panel:
<device>_transport_status: PREVIEW, STOPPED, PLAY, FORWARD, REWIND, JOG, SHUTTLE or RECORD.<device>_speed: playback speed in % of normal;<device>_shuttle_pos: the same as a lever position 0-100.<device>_timecode,_display_timecode,_timeline_position(frame),_playhead_pos(0-100 of the timeline). Without Live timecode and playhead they change when the transport changes state, not every frame.<device>_current_clip_id,_current_clip_name,_clip_count,_loop,_single_clip,_video_format,_input_video_format,_reference_locked.<device>_slot_id,_slot_name,_record_time_left(HH:MM:SS on the active slot); per slot:_slot1_status,_slot1_volume,_slot1_minutes_left,_slot1_free_gb,_slot1_total_gb.<device>_remote_enabled,_connection(connected / disconnected),_model,_software_version,_protocol_version, and<device>_config_video_input,_config_file_format... one for each configuration setting.
Generic Command Format:
Any action id that is not one of the handler's own is sent as it is, so the protocol's commands work directly. Examples:
play,stop,recordgoto: clip id: 1,goto: timecode: 00:01:30:00jog: timecode: +00:00:00:10,shuttle: speed: 200notify: transport: true slot: true remote: true configuration: true
Integration Examples (assuming device name "HYPERDECK_RECORDER"):
Via HTTP GET:
http://<FantaGo_IP>:<HTTP_PORT>/sendTo/HYPERDECK_RECORDER?cmd=play
http://<FantaGo_IP>:<HTTP_PORT>/sendTo/HYPERDECK_RECORDER?cmd=goto:%20clip%20id:%202
Via TCP/UDP Listener:
HYPERDECK_RECORDER:play
HYPERDECK_RECORDER:goto: clip id: 2
Remember to URL-encode the command string for HTTP GET requests.
Blackmagic HyperDeck control — frequently asked questions
Does Fantago support Blackmagic HyperDeck?
Yes. Fantago includes a ready-made Blackmagic HyperDeck handler (version 2.0.3) that talks to the device over TCP, default port 9993. It is bundled with every licence and with the 60-day free trial — there is no per-device fee.
What protocol does the Blackmagic HyperDeck handler use?
TCP, default port 9993. Fantago connects straight to the device over your production network, so no gateway, middleware or vendor software is needed in between.
Can I control Blackmagic HyperDeck from a Stream Deck?
Yes. Every Blackmagic HyperDeck 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 Blackmagic HyperDeck handler?
Yes. The handler is a plain JavaScript file (bmd_hyperdeck.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 Blackmagic HyperDeck from a single interface
Fantago drives Blackmagic HyperDeck 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.