Blackmagic Design Web Presenter Installation and Operation Manual
April 2021
Installation and Operation Manual
Blackmagic
Web Presenter
Blackmagic Web Presenter
Languages
To go directly to your preferred language, simply click on the hyperlinks listed in the
contents below.
English 3
日本語 40
Français 78
Deutsch 116
Español 154
中文 192
한국어 230
Русский 268
Italiano 306
Português 344
Türkçe 382
English
Welcome
Thank you for purchasing your Blackmagic Web Presenter!
Blackmagic Web Presenter plugs directly into any SDI equipment, converts the signal
into H.264 and lets you stream it on popular streaming services such as YouTube Live,
Facebook Live and Twitch. You can also transmit broadcast quality video point to point
using an optional ATEM Streaming Bridge. This makes transmission of professional video
toremote locations easy using the internet!
This instruction manual shows you everything you need to know to get started with
Blackmagic Web Presenter and how to use all the features and controls, including how
toset everything up for YouTube Live, Facebook Live, Twitch, Zoom, Skype and more.
Check the support page on our website at www.blackmagicdesign.com for the latest
version of this manual and for updates to your Blackmagic Web Presenter’s internal
software. When downloading the software, be sure to register with your information so
wecan keep you updated when new software is released.
We are continually working on new features and improvements, so we are keen
hear from you!
Grant Petty
CEO Blackmagic Design
Contents
Getting Started 5
Using Web Presenter’s Front Panel 7
LCD Display 9
Using the Monitor Output 10
Using Web Presenter Setup 15
Live Stream Tab 16
Setup Tab 17
Network Settings 18
Setting Internet Sharing forDirectStreaming 18
Streaming Using Your Smartphone 19
Using Blackmagic Web Presenter as a Webcam 19
Setting up Open Broadcaster 20
Creating Video Links with ATEM Streaming Bridge 22
Teranex Mini Rack Shelf 23
Updating the Internal Software 24
Developer Information 25
Blackmagic Web Presenter Ethernet Protocol 25
Protocol Blocks 27
Help 36
Regulatory Notices 37
Safety Information 38
Warranty 39
4Blackmagic Web Presenter
Getting Started
Getting started with your Blackmagic Web Presenter is quick and easy! All you need to do
isconnect power, connect video and audio, connect the unit to your computer, then connect to
the internet.
Blackmagic Web Presenter front panel
Connecting Power
Plug a standard IEC power cable into your Blackmagic Web Presenter’s powerinput on the
rear panel.
Blackmagic Web Presenter can be powered using the IEC or 12V DC power input
Web Presenter also has an additional 12V DC power input. You can use this input if you want to
connect external power or redundancy via an external power supply, for example a UPS or
external 12V battery.
Connecting Video and Audio
Plug your video source into Blackmagic Web Presenter’s SDI input. When video is connected it
will be displayed on your web presenter’s built in LCD. Audio is embedded with the video on
the SDI video signal and you can confirm it by observing the audio meters on the LCD.
Connect video to your Blackmagic Web Presenter’s SDI input
Blackmagic Web Presenter supports 12G-SDI and will automatically switch between HD
and Ultra HD all the way up to 2160p60 when the video input changes. While Blackmagic
WebPresenter4K can stream in Ultra HD, Blackmagic Web PresenterHD will take virtually any
video signal and convert down to 1080p.
5Getting Started
Connecting a Monitor
Plug your HDMI television or SDI monitor into one of the monitor outputs. This lets you monitor
your broadcast and observe important status information that updates constantly with your
video stream. For more information on how to use the monitor output, refer to the ‘Using the
Monitor Output’ section.
Connect a monitor to your web presenter’s monitor output
Connecting to a Computer via USB
Connect your Web Presenter to your computer using the USB-C port on the front or rear panel.
These USB ports are used for updating the unit and configuring it with the Blackmagic Web
Presenter Setup utility. Once you have configured your Web Presenter for the first time, you can
then disconnect the unit from the computer.
Connect your Blackmagic Web Presenter to your computer
using the USB port on the front or rear panel
Connecting to the Internet
Connect your Blackmagic Web Presenter to the internet by plugging a network cable from the
‘live stream’ Ethernet port to an internet router or a network switch.
Connect your Blackmagic Web Presenter to your
network via the Ethernet port on the rear panel
6Getting Started
Setting up a Live Stream
You can now setup your Web Presenter to stream via any streaming platform such as YouTube
Live, Facebook Live, Twitch and more. For this example, we will set up for a YouTube
Live stream.
1 Copy your stream key from your YouTube Studio account.
2 Download the Blackmagic Web Presenter Setup utility from
www.blackmagicdesign.com/support and install it on your computer.
This software lets you configure streaming settings for the first time.
3 Launch the Blackmagic Web Presenter Setup utility and go to the ‘live stream’ page.
4 Set the platform to YouTube and the server to ‘primary’. Paste your YouTube stream key
into the ‘key’ field and select a streaming quality. Click ‘save’.
5 You’re now ready to start streaming to the world! Click the ‘on air’ button or press the
‘on air’ button on the unit’s front panel. When your production has finished, press the
‘off’ button to stop your broadcast.
Using Web Presenter’s Front Panel
Use Blackmagic Web Presenter’s front panel controls to start and stop streaming and
change settings.
On Air - To start streaming, simply press the ‘on air’ button. The button will highlight red while
streaming on air.
If the on air button flashes, it means a live stream has failed to start, or has stopped
unexpectedly. This might be due to a problem with your internet connection or streaming
settings. Check that your internet connection is working and your streaming settings
are correct.
Off - To stop streaming, press the ‘off’ button.
7Using Web Presenter’s Front Panel
Menu - Press the menu button to open the settings on the LCD.
To change a setting:
1 Rotate the knob to select the setting you want to change, then press ‘set’.
2 Rotate the knob to change your setting.
3 Press ‘set’ again to confirm the change.
Press the menu button to step back through the menu items and return to the home screen.
Call - This feature will be enabled in a future update.
Lock - Press and hold this button for 1 second to lock the panel. This disables the buttons,
preventing anyone from accidentally going on air or stopping a stream. The button will
illuminate red when active.
Press and hold for 2 seconds to unlock the panel.
8Using Web Presenter’s Front Panel
LCD Display
The home screen is the first feature you’ll see when you power up your Web Presenter.
The home screen displays important information, including:
Duration Counter – Shows the
current duration of your live
stream. The counter will start when
you press the ‘on air’ button.
Internet Connection –
Asmall icon is displayed
Data Rate – Shows
the data rate of the
encoder whether or
not your WebPresenter
is streaming. You can
connect your video
source to an input and
quickly see the bit rate
required to stream
your live video feed.
whenyour Web Presenter is
connected to the network.
Cache – Showsthe
percentage of your Web
Presenter’s built in memory
cache that is currently in use.
Video Monitor – Displays the input video source
that is connected to your Web Presenter.
On Air Status – A bright red on
air indicator will be displayed
when your live stream is running.
When the unit is standing by
ready to start streaming ‘off’ will
be displayed. Aflashing red and
white on air indicator means that
there has been an interruption
during the stream, such as a
slow internet connection.
Audio Meters – Displays
the audio levels of the
video source connected
to your Web Presenter.
9Using Web Presenter’s Front Panel
Internet Connection Icons
A blue Ethernet icon is displayed when an Ethernet cable is connected and the
Ethernetconnection will be used for streaming.
A red Ethernet icon is displayed when on air and streaming via Ethernet.
A blue smartphone icon is displayed when a tethered smartphone’s internet
connectionwill be used for streaming.
A red smartphone icon is displayed when on air and streaming via a tethered
smartphone.
TIP If no icon is displayed then your Web Presenter is not connected to the network.
Using the Monitor Output
The monitor output lets you monitor the video input, audio levels, on air status, data rate and
cache levels, plus technical information about the SDI input.
The monitor out on Blackmagic Web Presenter provides comprehensive
information including data rate and cache status.
10Using the Monitor Output
The monitor output display is made up of 8 panels. Below is a description of each panel and the
information it displays.
Input View
The main panel displays your current video input from the connected SDI video source.
On Air Status
Prior to streaming, the on air status indicator will display ‘off’ to let you know
Web Presenter is standing by and ready to broadcast. When streaming begins,
theindicator will display a bright red ‘on air’ status until streaming is stopped.
Underneath the on air indicator is the duration counter. When you press the on air
button on your Web Presenter, the duration counter will start running.
If your Web Presenter is off air but will stream via a tethered smartphone, the ‘off’
indicator includes a blue smartphone icon in the corner. When on air, the smartphone
icon will illuminate red.
Live Stream
The live stream panel displays information about your live stream settings. This includes
the streaming platform, server and the first 10 digits of your streaming key. It also
displays the stream resolution and quality settings.
11Using the Monitor Output
Video Input
The 5 mini viewers at the top of the video input panel show the previous 6 seconds of
your live stream, each mini viewer represents 1.2 seconds of streaming time.
Below the mini viewers you can view detailed technical information about the video
input source connected to your Web Presenter’s SDI input.
Input Standard Displays the resolution and frame rate of the SDI video input.
Web Presenter supports up to 2160p60.
Colorimetry Shows the color space of the SDI video input. Web Presenter
supports Rec.601, Rec.709 and Rec.2020 color spaces.
SDI Ancillary Data Ancillary data is data carried in the SDI video input that is in
addition to video. This includes embedded audio, timecode and
closed captions. If your SDI input includes ancillary data then
‘Present’ will be displayed.
Timecode Displays the timecode from the SDI video input source.
Closed Captions If your SDI video input includes Closed Captions the format will be
displayed here. CEA-608 and CEA-708 formats are supported.
SMPTE 292 CRC This is an error checking function for SDI video. If your
Web Presenter detects a problem in the SDI video input it will
display an error. CRC errors are usually caused by a faulty SDI cable
or a cable that is too long.
Luminance Y Bits
and Chroma Bits
The indicators for ‘luminance y bits’ and ‘chroma bits’ show you
the activity of the SDI video input signal. Each letter represents the
state of one bit of the video signal.
X - An ‘X’ indicates a constantly changing bit.
L - A low bit.
H - A high bit.
SDI offsets are subtracted to make it easy to understand. For
example, all bits are low when video is black.
Generally, all 10 bits for your SDI video input will show ‘X’ to mean
all the bits on your video stream are changing constantly. If your
SDI input is 8 bit video, the two rightmost bits will always be ‘L’ as
they don’t have any data. If a bit stays ‘L’ or ‘H’ when you expect
itto be ‘X’, this indicates a ‘stuck bit’ and could be the result of a
fault in the upstream video.
12Using the Monitor Output
Audio Input
The audio waveform display at the top of the audio input panel shows the audio
information for the past 6 seconds of your live stream. This is continually updated and
scrolls from right to left.
Below the audio waveform display you can view detailed technical information about
the audio input.
Sample Frequency Displays the sample frequency rate of the audio embedded
in the SDI input.
Emphasis Indicates if your audio source has its emphasis option enabled.
Audio Source Lock Indicates whether the audio source frequency is locked to an
external reference source.
Word Length Shows the bit depth of the audio embedded in the SDI input.
Origin These four characters indicate the channel origin.
Time of Day Free run timecode.
Audio Bits Shows the bit activity in the audio samples embedded in the
SDI connection. Even if the audio channel status says you have
16, 20 or 24 bit audio, the audio bit activity will confirm it.
VUCP Reading VUCP bits from left to right: the ‘V’ bit indicates ‘valid’,
‘U’is the ‘user’ bit, ‘C’ is the ‘channel status’ bit, and ‘P’ is for
‘parity’. This field is like ‘audio bits’.
Sample Address Audio sample counter.
AUX Bits Use Indicates whether AUX bits are used for main audio.
Audio Channels 1-32 Each digit represents an embedded audio channel on the SDI input.
A ‘P’ shows that an audio channel is in use and a ‘-’ means that
there is no audio on that channel.
13Using the Monitor Output
Data Rate Display
The data rate display shows the current data rate of of the encoder over the past
60 seconds. The data rate is measured in megabits per second. This indicator runs
consistently, even when off air, so you can accurately gauge your bandwidth before
going on air.
Cache Display
The cache display shows the percentage of Web Presenter HD’s built in memory buffer
that is currently in use and the graph shows the amount used over the past 60 seconds.
The cache is a small amount of internal memory that continuously records and plays the
program output. It acts as a safety measure if the streaming data rate decreases below
a level able to sustain video.
The variable nature of the internet is mostly due to network activity or wireless signal
strength, so if the broadcast data rate decreases, the buffer data will increase
accordingly. If the connection speed becomes slow enough that it cannot support the
video stream, the cache will fill with video frames to compensate. However, once the
cache is 100% full, the video stream will be compromised, so you will want to avoid a
full cache where possible. You can run a test by connecting a video feed and watching
the cache display in the monitor output without having to start the stream. If the cache
frequently approaches 100%, choose a lower quality in the live stream settings.
Audio Meters
You can monitor the levels of your audio source using the audio meters. These can be
set to display either PPM or VU levels in the Web Presenter’s menu settings. If your
audio levels are too high the meters will illuminate red and may mean that the audio in
your live stream could become distorted or clipped. Ideally try to keep your audio
towards the top of the green section and occasionally in to the yellow section.
14Using the Monitor Output
Using Web Presenter Setup
When your Blackmagic Web Presenter is connected to a network, any computer connected to
the same network can be used to control your Web Presenter remotely. With Blackmagic Web
Presenter Setup, you can access the same controls and settings that are available on the unit’s
front panel.
15Using Web Presenter Setup
Live Stream Tab
Video Output
Stream Standard
Click on the ‘stream standard’ menu to select the video resolution setting for your
stream. Youcan choose from 720p25 up to 1080p60 or 2160p60 depending on which
WebPresenter model you are using.
Settings
If you have custom streaming settings, for example an XML file from a Blackmagic
ATEM Streaming Bridge, you can import them by clicking the ‘load streaming
settings’ button.
For more information on creating custom settings and connecting to ATEM Streaming
Bridge, refer to the ‘Creating Video Links with ATEM Streaming Bridge’ section later in
this manual.
Live Stream
Platform
Click the ‘Platform’ menu to select the streaming platform for your broadcast. Options
include YouTube, Facebook and Twitch. If you have imported custom streaming settings
they will also appear in the platform list.
Server
Select the server that is closest to your location by selecting it from the list. The server
list will vary depending on your chosen streaming platform.
Key
Enter the streaming key that has been assigned to your broadcast from the
streaming platform.
Quality
Select the streaming quality for HD or 4K, depending on which Web Presenter model
you are using.
HD 4K
HyperDeck High 45 to 70 Mb/s HyperDeck High 95 to 220 Mb/s
HyperDeck Medium 25 to 45 Mb/s HyperDeck Medium 66 to 150 Mb/s
HyperDeck Low 12 to 20 Mb/s HyperDeck Low 38 to 80 Mb/s
Streaming High 6 to 9 Mb/s Streaming High 34 to 51 Mb/s
Streaming Medium 4.5 to 7 Mb/s Streaming Medium 23 to 35 Mb/s
Streaming Low 3 to 4.5 Mb/s Streaming Low 13 to 20 Mb/s
The data rate used by the quality setting will change depending on the video standard
Web Presenter is using. For example, if you select ‘streaming high’ quality and are
running at 1080p24 then it would use the 6 Mb/s data rate.
16Using Web Presenter Setup
As you can see in the table, the streaming data rates are lower compared to the
HyperDeck rates. This allows for transmitting data over the internet which typically uses
a lower bandwidth compared to recording data on a disk.
You will notice that each setting has 2 data rates mentioned. The lower number is used
for the lower frame rates of 24p, 25p and 30p, while the higher data rates are used
when you are running higher frame rates of 50p and 60p. It’s also worth noting that the
default setting for the streaming quality is Streaming High, as this gives a very high
quality streaming channel.
Off and On Air buttons
You can start or stop a live stream by using the ‘off’ and ‘on air’ buttons. The ‘on air’ button
illuminates red when a live stream is in progress.
Setup Tab
Name
If you want to rename your Web Presenter, type a new name into the box and click ‘save’.
Language
Lets you change the unit’s language setting.
Software
Displays Web Presenter’s current software version.
Audio Meters
Use the menu to choose the type of audio meter to display. Choose from VU -18dBFS,
VU-20dBFS, PPM -18dBFS or PPM -20dBFS reference levels.
17Using Web Presenter Setup
Network
These settings allow you to configure options such as choosing between connecting to a
network over DHCP or using a static IP address. For more information on connecting your
WebPresenter to a network, refer to the ‘network settings’ section.
Connection Priority - When Ethernet and a mobile phone are both connected to
theWeb Presenter, this setting lets you choose which connection will be used for
streaming. For more information on mobile tethering, refer to the ‘streaming using
yoursmartphone’ section
Reset
Reset your Web Presenter by clicking the ‘factory reset’ button.
Network Settings
Your Web Presenter can connect to the network using a static IP address or by using DHCP.
DHCP - will automatically set an IP address for your unit and connect it to your network without
any settings changed.
The dynamic host configuration protocol, or DHCP, is a service on network servers and routers
that automatically finds your Web Presenter and assigns an IP address. DHCP makes it easy to
connect equipment via Ethernet and make sure that IP addresses do not conflict with each
other. Most computers and network switches support DHCP.
Static IP - If you want to set the IP address yourself, simply set the protocol setting to ‘static IP’
and change the IP settings manually.
A static IP address is one that won’t change even if your Web Presenter is rebooted.
Using a static IP address might be necessary if your connecting your Web Presenter to a
corporate network. If you have a network administrator, it’s possible your network might have
custom IP addresses for all the equipment connected to it. It’s best to check with your network
administrator if they are managing your computers and network in your company.
Setting Internet Sharing
forDirectStreaming
If you are unable to plug Web Presenter directly into a network switch or internet router, youcan
share your computer’s internet connection with Web Presenter through its Ethernet port.
To set up Blackmagic Web Presenter for direct streaming:
1 Set your Web Presenter to use DHCP.
2 Configure your computer to share its internet connection through its Ethernet port.
Mac: in System Preferences, click ‘sharing’ then select ‘internet sharing’ from the
‘service’ list. In the ‘share your connection from’ menu, choose ‘wi-fi’ if your Mac is
connected to the internet over wifi. In the ‘to computers using’ list, select ‘ethernet’.
Inthe ‘service’ list, tick the ‘internet sharing’ checkbox. When you are asked if you are
sure you want to turn on internet sharing, click ‘start’.
18Setting Internet Sharing forDirectStreaming
Windows: right click the ‘start’ icon and select ‘network connections’. The ‘network
status’ screen appears. Click on ‘change adapter options’. This lists your computer’s
network connections. Right click on the internet connection and select ‘properties’.
Onthe ‘sharing’ tab, tick ‘allow other network users to connect through this computer’s
internet connection’. Select a network connection in the menu then click ‘OK’.
3 Plug Web Presenter into your computer’s Ethernet port. After a few seconds,
DHCPassigns an IP address to Web Presenter.
4 Confirm your Web Presenter is connected to the internet via Ethernet by observing
Ethernet icon in the top right corner on the unit’s LCD screen.
Streaming Using Your Smartphone
Blackmagic Web Presenter is able to stream by tethering to your smartphone. This means you
can stream to the world from any location where your smartphone has a cellular connection.
To set up mobile tethering:
1 Connect your smartphone to Blackmagic Web Presenter using a USB-C cable. You can
use the USB-C connector on the front or back panel.
2 Enable your smartphone’s internet hotspot.
On your iOS device open settings > personal hotspot and make sure ‘allow others to join’
option is on. On your Android device swipe the screen to display the quick menu. Press and
hold the hotspot icon and then turn on USB tethering.
Now you can press the ‘on air’ button on your Blackmagic Web Presenter to go live.
TIP Once you’ve finished streaming, we recommend you switch off tethering
connections to save your smartphone’s battery life.
If your Web Presenter had an Ethernet cable connected, you are advised to confirm it is
configured to use mobile internet tethering. Open the Web Presenter Setup utility and go to the
‘setup’ tab. In the ‘network’ section, set the connection priority to ‘mobile’.
Using Blackmagic Web Presenter as a Webcam
Software such as Skype or Zoom should automatically set Web Presenter as the webcam, so
when you launch the application you will see video from your Web Presenter immediately. If the
application doesn’t select Web Presenter automatically, manually set it touse Web Presenter as
the webcam and microphone.
Below is an example of how to set the webcam settings on Skype.
1 In Skype’s menu bar, open the ‘video and audio settings’.
2 Click on the ‘Camera’ menu and select your Web Presenter from the list. You will see
the video from Web Presenter appear in the preview window.
3 Go to the ‘Microphone’ menu and select your Web Presenter as your audio source.
19Using Blackmagic Web Presenter as a Webcam
Setting up Open Broadcaster
Open Broadcaster is an open source application that works as a streaming platform between
your Web Presenter and your favorite streaming software like YouTube, Twitch, Facebook Live
and others. Broadcaster compresses your video to a bit rate that is easily managed by your
streaming app.
Below is a demonstration of how to set up Open Broadcaster to stream the webcam output
from your Web Presenter using YouTube Live as the streaming service.
1 2
Launch Open Broadcaster and click on the
plussymbol in the ‘sources’ box.
3
Name the new source and click ‘OK’. In the device menu, select your WebPresenter
Select ‘Video Capture Device’.
4
model and click ‘OK’.
5 6
Now go to your YouTube account. Click on the
‘golive’ button then click ‘stream’.
In the YouTube ‘stream’ options, enter your
broadcast details and click ‘create stream’.
20Using Blackmagic Web Presenter as a Webcam
7 8
YouTube will now generate a stream key
that will direct Open Broadcaster to your
YouTube account.
Click the ‘copy’ button next to the stream key.
Copy the stream key that you will now paste
intoOpen Broadcaster.
9 10
To connect Open Broadcaster’s broadcast
link to YouTube, click ‘start streaming’
in the bottom right corner of the screen.
This establishes the link to YouTube from
Open Broadcaster and from here everything
will now be set using YouTube Live.
Return to Open Broadcaster and open the
preferences by clicking on ‘OBS/preferences’
in themenu bar. Select ‘stream’. Now paste
in the stream key you copied from YouTube
and click ‘OK’.
You will now see the video from your
Web Presenter in the Open Broadcaster streaming
preview window.
Go back to YouTube Live and you will
see the webcam program output from your
Web Presenter in the background. Click ‘done’.
11 12
With Open Broadcaster now communicating
with YouTube Live, you are ready to begin your
broadcast. Now it’s time to perform your final
checks and make sure everything is good.
You are now broadcasting live on YouTube with Open Broadcaster.
NOTE Due to the nature of internet streaming there can often be a delay, so it’s
important to watch the stream on YouTube and confirm your program has finished
before clicking ‘end stream’ to make sure you don’t accidentally cut the end of your
broadcast short.
If you are all set, you can now begin your
broadcast by clicking ‘go live’.
21Using Blackmagic Web Presenter as a Webcam
Creating Video Links with ATEM Streaming Bridge
The ATEM Streaming Bridge allows you to decode the streaming video from any Web Presenter
and convert it back to SDI or HDMI video. It allows you to send video over your local network,
or to anywhere in the world via the internet.
If your ATEM Streaming Bridge is connected to the same local network as your WebPresenter,
it will be listed in the ‘platform’ menu on the live stream tab in WebPresenter Setup.
Otherwise, you can load a streaming setting XML file on a USB drive connected to the
WebPresenter or via your computer using Web Presenter Setup.
A good example of how Blackmagic Web Presenter can work with ATEM Streaming Bridge is
transmitting a weather report to a studio from a remote location. All you need for transmission
from location is a Web Presenter and an internet connection, which could be your smartphone
or by connecting to a network.
Back at the studio, the ATEM Streaming Bridge takes the internet feed and converts it to SDI
soit can be connected to the main switcher at the studio.
The workflow setup for this example would be:
1 On location, the Blackmagic Web Presenter is connected to the Program SDI output
onthe switcher. For example an ATEM Television Studio HD.
2 Blackmagic Web Presenter is then connected to a Smartphone.
3 Back at the studio, ATEM Streaming Bridge is also connected to the internet
via Ethernet.
4 The ATEM Streaming Bridge then sends the converted SDI video feed from the internet
to the studio switcher’s SDI input for the main news broadcast.
For your studio to connect ATEM Streaming Bridge to the Web Presenter’s internet feed, you
will need to launch the ATEM Setup utility and configure the internet settings. This includes
generating an XML file containing all the streaming settings which are then loaded into the Web
Presenter on location.
Refer to the ATEM Mini instruction manual for details on how to connect ATEM Streaming Bridge
to the internet and generate the streaming XML file.
22Creating Video Links with ATEM Streaming Bridge
Loading the Streaming XML File into the Remote Web Presenter
With the settings file emailed to the location, the location crew simply loads the XML into the
Web Presenter using Blackmagic Web Presenter setup, then presses on air to start streaming
the weather report to the studio!
It’s important to mention that once you have loaded the streaming XML file, you can then start
and stop streaming without ever having to load it again. This makes it easy to set up a constant
video link between the Web Presenter and the ATEM Streaming Bridge.
As long as the ATEM Streaming Bridge at the studio hasn’t changed the streaming and network
settings and is still looking for that Web Presenter, it will always find it no matter where it is on
the internet. At any location, you can simply plug your Web Presenter into the internet, press
‘onair’, and it will immediately be streaming to the ATEM Streaming Bridge back at the studio.
You can find more details on how to use ATEM Streaming Bridge in the ATEM Mini manual
which can be downloaded at www.blackmagicdesign.com/support
Teranex Mini Rack Shelf
Teranex Mini Rack Shelf is a 1 RU shelf that lets you install your Blackmagic Web Presenter into a
broadcast rack or road case. Your Web Presenter is so small, you can install it next toother
Blackmagic Design equipment that shares a similar form factor, such as Teranex Mini
converters, Blackmagic MultiView 4 and HyperDeck Studio Mini. For example, installing a
Blackmagic Web Presenter together with ATEM Television Studio HD gives you the ability
toswitch eight video inputs and live stream the program output through your Web Presenter.
This modular design lets you build your own custom video solutions that are portable and
easy to use!
Teranex Mini Rack Shelf lets you rack mount your Blackmagic Web Presenter
with other Blackmagic Design equipment that shares the same form factor,
such as Teranex Mini Converters and ATEM Television Studio HD
Installing your Blackmagic Web Presenter into a Teranex Mini Rack Shelf is as easy as removing
the unit’s rubber feet, if installed, and fastening the unit to the base of the shelf using the
supplied screws. The Teranex Mini Rack Shelf ships with two original blank panels which you
can use to cover gaps if you don’t need to install additional Blackmagic Design equipment.
For more information check the Blackmagic Design website at www.blackmagicdesign.com
23Teranex Mini Rack Shelf
Updating the Internal Software
The setup utility lets you update your Web Presenter’s internal software in addition to
configuring the streaming settings, network settings and streaming quality.
To update the internal software:
1 Download the newest Blackmagic Web Presenter installer from
www.blackmagicdesign.com/support.
2 Run the Blackmagic Web Presenter installer and follow the onscreen instructions.
3 After installation is complete, connect your Web Presenter to the computer via the USB
connector on the rear panel or on the front panel under the plastic dust cover.
4 Launch Blackmagic Web Presenter Setup and follow any onscreen prompt to update
the internal software. If no prompt appears, the internal software is up to date and there
is nothing further you need to do.
Download the latest setup utility for your BlackmagicWeb Presenter from
theBlackmagic Design support center at www.blackmagicdesign.com/support
24Updating the Internal Software
Developer Information
Blackmagic Web Presenter Ethernet Protocol
v1.0
Overview
The Blackmagic Web Presenter Ethernet Protocol is a line-oriented, text-based protocol to
control a Web Presenter. The Blackmagic Web Presenter Ethernet Protocol is available for
Blackmagic Web Presenter HD. Lines from the Web Presenter server will be separated by an
ASCII LF sequence. Messages from the user may be separated by LF or CR LF.
Connection
The Web Presenter server is accessed by connecting to TCP port 9977 on a Web Presenter.
Connection Response
Upon connection, the Web Presenter server sends a dump of the device’s state. The Web
Presenter server sends information in blocks, with each having an identifying header followed
by a colon. A block spans multiple lines and is terminated by a blank line. Each line in the
protocol is terminated by a newline character.
Following the header, a block contains either a single multi-line string or a sequence of key/
value pairs arranged one per line. The first colon on a line is used to delimit the key and the
value. A value may be a comma separated list. In this case, values in the list must have the “,”
and “\” characters escaped with a “\” character.
To be resilient to future protocol changes, clients should ignore blocks they do not recognize,
up to the trailing blank line. Within recognized blocks, clients should ignore keys they do not
recognize.
The protocol preamble block is always the first block sent by the Web Presenter server:
PROTOCOL PREAMBLE:
Legend
End of line
↵
... and so on
Orange Text Client Generated
Grey Text Server Generated
Ve r s io n: 1.0
↵
The version field indicates the protocol version. When the protocol is changed in a compatible
way, the minor version number will be updated. If incompatible changes are made, the major
version number will be updated.
The initial status dump is concluded by the end prelude block:
END PRELU DE:
↵
↵
↵
↵
25Developer Information
Status Updates
When any device parameter is changed on the Web Presenter server by any client, such as the
Blackmagic Web Presenter Setup utility, the Web Presenter server resends the applicable
status block, containing only the items that have changed. Status updates can also occur due to
external changes such as tethering to a smartphone or when a streaming service is
disconnected.
For example. if the input video mode is set to Auto, the following block will be sent:
ST R EA M SETT I NGS:
Video Mode: Auto
↵
↵
↵
Requesting Changes
To change one or more parameters in a block, the client should send the appropriate block
header in the same form the Web Presenter server sends, followed by the key/value pairs to be
changed. For example, to change the input video format to 1080p59.94, the user should send
the following block:
ST R EA M SETT I NGS:
Video Mode: 1080p59.94
↵
The block must be terminated by a blank line. On receipt of a blank line, the Web Presenter
server will either acknowledge the request by responding:
ACK
↵
↵
or if unable to parse the block responding with:
NACK
↵
↵
↵
↵
After a positive response, the client should expect to see a status update from the Web
Presenter server showing the status change. This is likely to be the same as the command that
was sent, sometimes followed by other blocks providing data specific to the change.
ST R EA M SETT I NGS:
Video Mode: 1080p59.94
↵
↵
↵
If the Web Presenter server does not understand a key in the requested block, the key will be
ignored. If an invalid value is provided for a known key, then the request is ignored and the Web
Presenter will respond with the existing value for the key. In both cases the Web Presenter
server will still respond with an ACK.
ST R EA M SETT I NGS:
Video Mode: UnsupportedMode
↵
ACK
↵
↵
ST R EA M SETT I NGS:
Video Mode: 1080p59.94
↵
↵
↵
↵
↵
26Developer Information
Requesting a Status Dump
The user may request that the Web Presenter server resend the complete state of any status
block by sending the block header, followed by a blank line. In the following example, the user
requests the Web Presenter server resend the stream settings:
ST R EA M SETT I NGS:
↵
ACK
↵
↵
ST R EA M SETT I NGS:
Video Mode: 1080p59.94
...
↵
↵
↵
↵
Protocol Blocks
Identity Block
The identity block contains information to identify the connected Web Presenter.
Block Syntax
The following example shows the Identity Block for a Blackmagic Web Presenter HD.
IDE N T I T Y:
Model: Blackmagic Web Presenter HD
Label: Blackmagic Web Presenter HD
Unique ID: 00112233445566778899A ABBCCDDEEFF
↵
↵
↵
↵
↵
Parameters
Key Read/Write Description Valid Values
Model Read only The Web Presenter model name String
Label Read/Write A display name for the Web Presenter String
Unique ID Read only A device specific unique identifier Hexadecimal ID
Changing Device Label
A device label to identify the Web Presenter can be changed by sending an identity block with
label key.
IDE N T I T Y:
Label: My Web Presenter
↵
ACK
↵
↵
↵
↵
27Developer Information
Version Block
The version block contains hardware and software version information for the connected
Web Presenter.
Block Syntax
VERSION:
Product ID: BE73
Hardware Version: 0100
Software Version: 48858B6F
Software Release: 2.0
↵
Parameters
Key Read/Write Description Valid Values
Product ID Read only The Web Presenter product ID Hexadecimal ID
Hardware Version Read only The Web Presenter hardware version Hexadecimal version
Software Version Read only The Web Presenter software version Hexadecimal version
Software Release Read only The Web Presenter software release version Version Number
↵
↵
↵
↵
↵
Network Blocks
The network block contains the TCP/IP networking configuration for the connected Web
Presenter.
Block Syntax
This example shows the output for a connected Web Presenter. It displays 2 networking
interfaces - the Gigabit Ethernet interface and option for a tethered smartphone.
The network settings prefixed with Current show the active TCP/IP settings, and are read-only.
The Current settings reflect either the DHCP or Static configuration, depending on the
Dynamic IP flag.
NET WOR K:
Interface Count: 2
Default Interface: 0
St a tic D N S S er v ers: 8.8.8.8, 8.8.4.4
Current DNS Servers: 192.168.1.1, 8.8.4.4
↵
NETWORK INTERFACE 0:
Name: Cadence GigE Ethernet MAC
Priority: 1
M A C A d dress: 00:11:22:33:44:55
Dynamic IP: true
Cu r r e nt A d d resse s: 1 92.168.1.10/255.255.255.0
Current Gateway: 192.168.1.1
Stat i c A d d re sses: 10.0.0.2/255.255.255.0
Stat i c G a t e w a y: 10.0.0.1
↵
↵
↵
↵
↵
↵
↵
↵
↵
↵
↵
↵
↵
↵
↵
28Developer Information
NETWORK INTERFACE 1:
Name: USB Ethernet
Priority: 0
↵
M A C A d d ress: 00:00:00:00:00:00
Dynamic IP: true
Cu r re nt A d d ress e s: 0.0.0.0/255.255.0.0
Cu r re nt G ate w ay: 0.0.0.0
Stat i c A d d re sses: 10.0.0.2/255.255.255.0
Stat i c G a t e w a y: 10.0.0.1
↵
↵
↵
↵
↵
↵
↵
↵
↵
Parameters
Network Block
Key Read/Write Description Valid Values
Interface Count Read only
Default Interface Read only The default networking interface Integer
Static DNS Servers Read only The IP addresses of the static DNS servers
Current DNS Servers Read only The IP addresses of the current DNS servers
Network Interface Block
Key Read/Write Description Valid Values
Name Read only The name of the networking interface String
Priority Read/Write
MAC Address Read Only MAC address of the networking interface IEEE 802 MAC address
Dynamic IP Read/Write Selects DHCP or Static IP configuration
Current Addresses Read Only The current IP address and Subnet mask {IPv4 address}/{Subnet Mask}
Current Gateway Read Only The current IP gateway address IPv4 address
The number of networking interfaces
supported by the Web Presenter
The priority of the network interface. When
multiple network interfaces are available,
the high priority interface will become the
default
Integer
Comma separated list of
IPv4 addresses
Comma separated list of
IPv4 addresses
Unsigned integer. The higher
number is the higher priority
true - DHCP enabled
false - Static IP
Static Addresses Read/Write
Static Gateway Read/Write Static gateway address when DHCP disabled IPv4 address
Status IP address and subnet mask when
DHCP disabled
{IPv4 address}/{Subnet Mask}
Changing Networking Settings
The network can be configured to use either DHCP or a static configuration. To enable DHCP
on Network Interface 0:
NETWORK INTERFACE 0:
Dynamic IP: true
↵
↵
↵
29Developer Information
ACK
↵
↵
NETWORK INTERFACE 0:
Dynamic IP: true
↵
↵
↵
To set a fixed IP address, supply all static parameters:
NETWORK INTERFACE 0:
Dynamic IP: false
St a t ic Add resse s: 192.168.1.2/255.255.255.0
Static G at e w a y: 192.168.1.1
↵
↵
↵
↵
↵
ACK
↵
↵
NETWORK INTERFACE 0:
Dynamic IP: false
St a t ic Add resse s: 192.168.1.2/255.255.255.0
Static G at e w a y: 192.168.1.1
↵
↵
↵
↵
↵
Changing network settings may cause the IP connection to be dropped.
UI Settings Block
The UI settings block contains the front panel LCD and monitor output settings for the
connected Web Presenter.
Block Syntax
UI S ETTIN G S:
Available Locales: en_US.UTF-8, zh_CN.UTF-8, ja_JP.UTF-8, ko_KR.UTF-8, es_
ES.UTF-8, de_DE.UTF-8, fr_FR.UTF-8, ru_RU.UTF-8, it_IT.UTF-8, pt_BR.UTF-8,
tr_TR.UTF-8
Current Locale: en_US.UTF-8
Available Audio Meters: PPM -18dB, PPM -20dB, VU -18dB, VU -20dB
Current Audio Meter: PPM -20dB
↵
↵
↵
↵
↵
↵
Parameters
Key Read/Write Description Valid Values
Available Locales Read only The locales available in the Web Presenter Comma separated list of locales
Current Locale Read/Write The current locale for Web Presenter
Available Audio Meters Read only
Current Audio Meter Read/Write The current audio meter
The available audio meters supported by the
Web Presenter
Refer to the locales from the
Available Locales field
Comma separated list of audio
meter types
Refer to the audio meters from the
Available Audio Meters field
30Developer Information
Loading...