Blog
How to control a Blackmagic HyperDeck via command line (Telnet)
Short answer: open Terminal on a Mac and type nc <HyperDeck IP> 9993, or open Command Prompt on Windows and type telnet <HyperDeck IP> 9993. Once connected, type record and press Enter to start recording, and stop to stop. No Blackmagic program is needed.
Do you want to control your HyperDeck via Telnet or command line, without using their software? In this video I show you step by step how to do it on Mac and on Windows, and how to install Telnet on Windows if you don't have it.
If you are searching for how to control a Blackmagic HyperDeck from the command line, HyperDeck Telnet commands for record and stop or HyperDeck Ethernet Protocol port 9993, this is the quick method: connect to the recorder's IP address on port 9993 from a Mac or Windows computer, type a command, and press Enter. You do not need any Blackmagic software to run a basic recording.
Below I expand my video with a quick-start table, a cleaned-up troubleshooting list, notes on security and automation, and an FAQ. The commands I show are the ones I use: record and stop. The full list is in the HyperDeck Ethernet Protocol PDF from Blackmagic Design, so check it for any other command. Names of menus can differ a little between operating system versions.
In this article
- The HyperDeck Ethernet Protocol commands
- How to find the HyperDeck IP address
- Control the HyperDeck from a Mac Terminal
- Control the HyperDeck from Windows Command Prompt
- Why use the command line instead of the software
- How to install Telnet on Windows
- Security warning: Telnet is not secure
- Quick start
- Troubleshooting connection problems
- Tips for automation and live production
- Why a HyperDeck over telnet is handy
- Frequently asked questions
- Watch the video
The HyperDeck Ethernet Protocol commands
If you go to the Blackmagic Design website, you will find the HyperDeck Ethernet Protocol. You can download that PDF, and it has all the commands: for instance play if you want to play, a range, record if you want to record, and stop if you want to stop. In my case, all I care about is record and stop, but if you need anything else, everything is there. The only thing I wasn't able to find is a command to delete or format the SD cards.
- Where to find it. On the Blackmagic Design website, search for the HyperDeck Ethernet Protocol and download the PDF.
- What it contains. The text commands the recorder understands, such as play, record and stop.
- What I use. Only record and stop. If you need more, the PDF is the reference.
- What I did not find. A command to delete or format the SD cards.
How to find the HyperDeck IP address
To connect, you need the IP of the device. If you are wondering how to know it, download the HyperDeck Studio software (HyperDeck Studio Plus in my case). In the software you will see where it says IP address; that is the IP you will use. Very simple. The port is always the same: 9993.
- Use the software. Download the HyperDeck Studio software (HyperDeck Studio Plus in my case). The software shows the IP address.
- Port. The port is always 9993.
- Tip. Write the IP address on the recorder or in your rack notes, and consider assigning a fixed IP so it does not change.
Control the HyperDeck from a Mac Terminal
- Press Command and Space, type terminal and press Enter.
- Type
nc, a space, the IP of the device, a space, and the port number 9993. In the video description I usenc 10.0.0.62 9993. - Press Enter and you are connected to the HyperDeck.
- Type
recordand press Enter, and it will start recording. - To stop, type
stopand press Enter. That's it, you don't need anything else.
- Press Command + Space, type terminal and press Enter.
- Type `nc`, a space, the IP of the HyperDeck, a space and `9993`. For example `nc 10.0.0.62 9993`.
- Press Enter to connect.
- Type `record` and press Enter to start recording.
- Type `stop` and press Enter to stop.
- Close the connection with Control + C when you are done.
Control the HyperDeck from Windows Command Prompt
- Click Start and type command. Instead of Terminal like on the Mac, here it is Command Prompt. Click it; you don't have to be administrator or anything like that.
- Type
telnet, then the IP, a space, and 9993, then press Enter. - You are in. Type
recordand press Enter to start recording. - Type
stopand press Enter to stop.
Just one person at a time will be able to use this connection.
- Click Start, type command and open Command Prompt. You do not need administrator rights.
- Type `telnet`, a space, the IP address, a space and `9993`, then press Enter.
- Type `record` and press Enter to start recording.
- Type `stop` and press Enter to stop.
- Only one person at a time can use this connection.
Why use the command line instead of the software
With the command line you can start, stop and check the HyperDeck from your computer fast, with no program needed. It helps when the recorder is in a rack or in another room, and it is the easy way to start automating your recording, because the same two commands, record and stop, are all you need for a basic workflow.
- Speed. Start and stop from your computer without opening a program.
- Remote. Helpful if the HyperDeck is in a rack or another room.
- Automation. The same two commands are all you need for a basic scripted workflow.
How to install Telnet on Windows
- Click Start and type Control Panel, then open it.
- Go to Programs.
- Click Turn Windows features on or off.
- In the list, find Telnet Client, check it and click OK.
- Wait a minute until everything is installed, and that's it.
- Click Start and type Control Panel, then open it.
- Go to Programs.
- Click Turn Windows features on or off.
- Find Telnet Client, check the box and click OK.
- Wait a minute until the installation finishes.
Security warning: Telnet is not secure
The only thing is that this is not secure. Anybody with Telnet on your network is able to control your device, so make sure to secure your network. That said, it is the easy way to control the recorder from your computer, for example when the HyperDeck is in a rack or in another room. If you need help, just let me know, you can hire me. I am in the US, and if you need tools or electronics, I can ship them to you.
- No authentication. Anyone on your network with Telnet can control the recorder.
- Protect the network. Use a trusted network, a separate VLAN if possible, and do not expose the recorder to the internet.
- Why it is still useful. It is a simple way to control the recorder from a computer when it is in a rack or another room.
Quick start
| Computer | Open | Command to connect | Start / stop |
|---|---|---|---|
| Mac | Terminal | `nc <IP> 9993` | `record` / `stop` |
| Windows | Command Prompt | `telnet <IP> 9993` | `record` / `stop` |
Troubleshooting connection problems
| Problem | What to check |
|---|---|
| "telnet is not recognized" on Windows | Install the Telnet Client in Windows features, as shown above. |
| Connection times out | Check that the computer and HyperDeck are on the same network and that the IP address is correct. |
| Connection refused or no response | Make sure only one connection is open, since only one person can use it at a time. Close other connections and try again. |
| IP address changed | Check the IP in the HyperDeck Studio software again or set a fixed IP. |
| Command does not work | Check the spelling and press Enter. Look the command up in the Ethernet Protocol PDF. |
Tips for automation and live production
- Check the status in the HyperDeck software before a live event.
- Test your start and stop commands before the real recording.
- A script or control tool on your network can send the same text commands, once you know the IP address and port.
- Keep a manual way to start and stop in case the network fails.
- Make sure there is enough space on the SD cards before you press record.
Why a HyperDeck over telnet is handy
In a production rack the recorder may be hard to reach. The command line lets one computer control it with no extra software and little setup. That is also why you should keep the network protected: the convenience comes from the fact that the connection is open.
For more video and network guides, see how to set up a Uraycoder 4K video encoder, how to build a video wall controller setup and how to extend a USB cable 150 feet.
Frequently asked questions
What port does the HyperDeck use for Telnet control?
Port 9993. On a Mac use nc followed by the IP and 9993; on Windows use telnet followed by the IP and 9993.
What are the HyperDeck commands to record and stop?
Type record and press Enter to start recording, and stop and press Enter to stop. The full list is in the HyperDeck Ethernet Protocol PDF on the Blackmagic website.
How do I find my HyperDeck IP address?
Open the HyperDeck Studio software from Blackmagic; it shows the IP address of the device.
Can I format the HyperDeck SD card from the command line?
I wasn't able to find a command to delete or format the SD cards in the protocol document.
What commands start and stop recording on a HyperDeck?
Type record and press Enter to start, and stop and press Enter to stop.
Do I need Blackmagic software?
Only to look up the IP address of the recorder. After that, a Mac Terminal or Windows Command Prompt is enough.
Can several people connect at once?
In the video I note that just one person at a time can use this connection, so close any other open connection if you cannot connect.
How do I close the connection on a Mac?
Press Control + C in Terminal.
Is Telnet safe on my network?
It has no security, so anybody on the network who can reach the recorder can control it. Use a protected network.
Where is the full list of commands?
In the HyperDeck Ethernet Protocol PDF on the Blackmagic Design website.
Watch the video




Comments
Comments appear after Gabriel reviews them.
Loading comments…