Developer Information
Blackmagic HyperDeck Ethernet Protocol
The Blackmagic HyperDeck Ethernet Protocol is a text based protocol accessed by connecting
to TCP port 9993 on HyperDeck Extreme. If you are a software developer you can use the
protocol to construct devices that integrate with our products. Here at Blackmagic Design
our approach is to open up our protocols and we eagerly look forward to seeing what you
come up with!
You can connect to your HyperDeck recorder using the HyperDeck Ethernet Protocol
using a command line program on your computer, such as Terminal on a Mac and putty
on a Windows computer.
The HyperDeck Ethernet Protocol lets you schedule playlists and recordings. The following
is an example of how to play 7 clips from clip number 5 onwards via the HyperDeck Ethernet
Protocol. If your recorder is installed out of reach, you can also turn on the 'remote' feature
via Ethernet.
On a Mac
1
Open the Terminal application which is located with the applications > utilities folder.
2
Type in "nc" and a space followed by the IP address of your HyperDeck Extreme
another space and "9993" which is the HyperDeck Ethernet Protocol port number.
For example type: nc 192.168.1.154 9993. The Protocol preamble will appear.
3
Type "playrange set: clip id: 5 count: 7" and press 'return'.
If you look on the timeline on the front panel of the HyperDeck Extreme, you will see
in and out points marked around clips 5 through the end of clip 11.
4
Type "play". Clips 5 through 11 will now play back.
5
To clear the playrange, type "playrange clear"
6
To exit from the protocol, type 'quit'.
Protocol Commands
Command
help
commands
device info
disk list
disk list: slot id: {n}
quit
ping
preview: enable: {true/false}
play
play: speed: {-5000 to 5000}
play: loop: {true/false}
Command Description
Provides help text on all commands and parameters
return commands in XML format
return device information
query clip list on active disk
query clip list on disk in slot {n}
disconnect ethernet control
check device is responding
switch to preview or output
play from current timecode
play at specific speed
play in loops or stop-at-end
Developer Information
765