Setup of DVB compatible Streams

This article will show how to properly setup a new DVB compatible Stream.


Setup of basic Stream Settings

At first, DVB Streams are created like any other Stream in PLAYDECK, by going into the Settings and entering the appropriate Stream Info. In this case we use a local UDP URL for Testing, a High Framerate of 60 FPS, a medium Video Bitrate of 6 MBit/s, the standardized MPEG-2 Video Codec, a High Quality Audio with AAC Codec and 96 KHz Sample Rate and 320 KBit/s Bitrate:

There are 2 types of DVB Streaming:

  • Regular DVB Streaming via UDP (udp://…)
  • SRT DVB Streaming via SRT (srt://…)


Additional DVB Settings

DVB Streams rarely work out-of-the-box like other Stream Formats (e.g. RTMP), because the need specific additional Settings, which we walk-thru now. You can also use this official DVB Spec PDF as Reference.


PCR

PCR stands for “Program Clock Reference”, which is send by our DVB encoder. It’s kinda a “heartbeat” for the DVB Stream. If your network connection between PLAYDECK and DVB receiver is not reliable and stable, you will easily get PCR errors on your receiver. The PING from PLAYDECK to DVB receiver should never be higher than 20ms, even in peak times (e.g. other traffic).


MUXRATE

You should always set the Muxrate with this Formula:

MUXRATE = (VIDEO BITRATE + AUDIO BITRATE) * 1.25

So in our Sample above with have (rounded): 8 Mbit/s. We set the MUXRATE to PLAYDECK via the OPTIONS field of our Video Codec:

As a result, the resulting Bitstream will be of the MUXRATE value and non-video and non-audio parts are filled with null-packets.


CLOSED CAPTIONS + SCTE-35

Both dont need to be activated specifically, as they are automatically enabled by PLAYDECK.


INFORMATION TAGS

There are several informative fields, which are unique to DVB:

  • service_name (any text value)
  • service_provider (any text value)
  • service_id (any number – default is 1)
  • service_type (possible values: digital_tv, mpeg2_digital_hdtv, advanced_codec_digital_sdtv, advanced_codec_digital_hdtv, hevc_digital_hdtv – default is digital_tv)
  • transport_stream_id (any number – default is 1)
  • original_network_id (any number – default is 1)
  • pmt_start_pid (numbers between 16 to 7936 – default is 129)
  • start_pid (numbers between 256 to 3840 – default is 1024)
  • pes_payload_size (any number – default is 2930 bytes)
  • mpegts_flags (possible values: resend_headers, pat_pmt_at_frames, latm)
  • start_timecode (possible values: auto, disabled, local_time OR custom text like “10:00:00:00” – default is auto)
  • tables_version (any number – default is 0)

These values are also entered into the OPTIONS field of our Video Codec. You simply use a SPACE between options. Add as many options as you like/need:


Insert Input Streams into Playlist

This article will show how to insert Streams into your Playlist.


Insert Stream into PLAYDECK

You can directly Drag Drop any YouTube URL from your Browser to PLAYDECK:

To insert a new Stream into your Playlist, simply Drag Drop the STREAM Icon onto the Playlist. A new Popup will appear, where you can enter the Stream URL:

Your Stream will be scanned by PLAYDECK now. If the PLAYDECK could connect to your Stream successfully, the Text will be shown in WHITE. You can now play the Stream and/or can double-click the INFO icon to view more information about the Stream, like Video format and codec:

If the Stream can NOT be connected, it will appear in RED:

If you made a typo, you can quickly re-edit the URL by right-clicking and selecting CHANGE URL:


Insert YouTube

You can insert YouTube Links via Drag Drop or in the same manner as insert as Input Stream. See this article on more information about YouTube.


Insert Website

You can insert some Websites per Drag Drop directly into the Playlist or via the STREAM Icon. We use TWITCH in this example. Click SHOW HELP to get more info about what Websites can be used:


Move License to another PC

This article will show how to move your License from one System to another System.


Shop License

You can move your License via a simple Check-In/Out System. On the System with the active License, go into your License Manager:

First, we want to free the active License, so we can move it. Select the TRIAL Edition and click ACTIVATE, then confirm the restart query:

After restarting PLAYDECK, we can now move the free’d License back to your Online License Pool. Re-open the License Manager. Now login to your PLAYDECK ACCOUNT. Use the email adress and password, which you used during CHECKOUT in the SHOP. Use the FORGOT PASSWORD button, if you need to reset your password:

We can now move the License from you LEFT Side to the RIGHT Side with a Button Click (CHECK LICENSE BACK INTO THE POOL). This means, that the License becomes UNAVAILABLE on the current System and becomes AVAILABLE on ANY other System:

The next Screen shows the OTHER PC after logging into the License Manager. You simply reverse the Process now: Select the License on the RIGHT Side and move it with the Button to the Left Side (CHECK LICENSE FROM POOL TO LOCAL PC). PLAYDECK will now offer to activate the License and restart:


Dongle License

Simply detach the USB Dongle and attach it to another PC, then start PLAYDECK on that PC. Please note, that if you detach the Dongle while PLAYDECK is still running, PLAYDECK will close immediatly and without prior notice. It is recommended to close PLAYDECK regulary to ensure, that all Data is saved properly.


Offline License

The Offline License is bound to the PLAYDECK System ID and can NOT be moved to another System by the Customer. Please write us at [email protected] to receive a new Offline License.


Backup License

We have a separate article on how to use the Backup License.

Free Backup License

This article will show how to use the Free Backup License, which comes with every PLAYDECK License. The Backup License functions as follows:

  • Can be used with ANY PLAYDECK License (Dongle, Shop, Offline)
  • Can be used on ANY PLAYDECK-PC in the same network
  • Multiple Clients are supported
  • 24/7 operation is NOT supported (max 24h per session)


Setup

On your MAIN System (the one WITH the License), you dont have to do anything: The BACKUP LICENSE SYSTEM is enabled by default. It will use the WebSocket Port 11411, so make sure this Port is not blocked:

On the CLIENT System (the one WITHOUT the License), you perform a regular PLAYDECK installation, nothing special here: PLAYDECK will not start in TRIAL MODE with the watermark:

Now we need to tell CLIENT PLAYDECK, where to find the MAIN PLAYDECK, by providing the IP adress of MAIN. To receive the IP adress of your MAIN, you can simply open the ABOUT BOX in PLAYDECK (Main Menu > License > About):

On your CLIENT, go to Application Settings, enter the IP adress of MAIN PLAYDECK and click TEST IP NOW. The CLIENT now tests the Network connection and searches for a valid License on MAIN. If you dont see the following INFO POPUP, please check your MAIN License and your Network connection between MAIN and CLIENT:

You can now enable the feature by clicking BACKUP-SYSTEM. PLAYDECK will restart now with the exact same License of MAIN. You can verify, the CLIENT is using the Backup License correctly in several Displays:

Note: If the CLIENT has a valid License itself, the License of MAIN will NOT be used.


Rules of Backup-License

The Backup-License is not meant for 24/7 operation, but to provide a fail-safe for immediate operation, e.g. in a live production, and without the need to buy a secondary license, just to have a backup system for some use cases.

For unattended 24/7 operation, you would need to purchase a secondary license. Please contact use at [email protected], if your next License is for Backup only, and we will provide you with a appropriate discount.

The MAXIMUM RUNTIME of your BACKUP LICENSE will be:
– 2 hours, if the MAIN gets disconnected or closed
– 24 hours, if then MAIN stays online

PALYDECK will terminate the CLIENT without prior warning. So please make sure, to bring the MAIN back online within the 2 hour window, or to restart both MAIN and CLIENT within the 24 hour window.

You can control the remaining RUNTIME in the Settings of the CLIENT:

Creating a Diashow Single-Monitor

This article will show how to create a Diashow with Transitions and output on the same Monitor.


Creating the Show

Open the integrated File Explorer by clicking the right-arror between the Playlists. The search for your images folder, select all images and add the to the Playlist by Drag Drop:

Select any Clip in the Playlist and press CTRL+A to select all Clips, then select the Icon for DURATION and enter a suitable duration for each image, e.g. 15 seconds:

While al Clips are still selected, click the Icon TRANSITION next and add any transition. In this case we use a smooth long Fade Transition:

At the bottom of the Playlist you can see the total duration of your Diashow:


Playing the Diashow

You simply double-click the first Clip (or use Buttons CUE+PLAY), then double-click the Preview Area (or right-click and select FULLSCREEN). Your Playout will now be maximized to your Monitor Size, at maximum Quality. And the Mouse Cursor will be hidden. Use ESC to exit Fullscreen.

Note: During Fullscreen, you can use the SPACE Key to pause/unpause Playback.

You can also output the video signal on a second monitor, or send it to your TV. You could also send it via NDI to another PC and open the signal with PLAYDECK (use the free Backup License), or VCL Mediaplayer or any other 3rd party app:


Using Commands for Playout Control

This article will show how to use Commands to control your Playout.


Example: CUE+PLAY multiple Channel

We want to create an Action Button, which will CUE several Output Channel and PLAY them simultaneously (almost synced).

Create a new Action Button by clicking on it and select COMMANDS, then EDIT COMMANDS:

Add this Line for the first Click (ACTION START).
<cue|1|1><cue|2|1><cue|3|1><cue|4|1>

This will cue the first Clip if Channel 1-4:

Add this Line for the second Click (ACTION END).
<pause|1><pause|2><pause|3><pause|4>

This will un-pause Channel 1-4 and send the CUE into PLAY:

Lets test our new Button: Add a Clip to Channel 1-4 then press the Action Button. Not wait, until all Channel turn GREEN, indicating the Clip has been CUE’d:

Then press the Action Button again to start playback of all channel.


List of all Commands and where to add them

The List of all Commands can be quickly opened over PLAYDECK’s Main Menu:

Commands can be added to:

  • Action Buttons (Start, End)
  • Overlay Button (Start, End)
  • Clips (Any Time)
  • Blocks (Start, End)

Mostly via this Icon:


Send Commands from other Apps

We have a sparate article on how to control PLAYDECK with Companion.

But what, if it is not Companion, but a different 3rd party App? First, you would need to enable TCP Commands. This will open PLAYDECK up to receive and execute Commands from external sources:

In your 3rd party app, connect to PLAYDECK via TCP and send one or multiple Commands. In this Sample we use Hercules to send a Command, which will start Streams 1 and 2:


Using Companion for Playout Control

This article will show how to use bitfocus Companion together with PLAYDECK. Companion has a ready-to-use module for PLAYDECK. This is the most comfortable way to connect PLAYDECK to your ATEM Mixer or STREAMDECK.


Installation

Enable TCP Commands in PLAYDECK to allow 3rd party apps to control PLAYDECK externally:

Download and install the latest Version of Companion. The PLAYDECK module is included in the installation:


https://bitfocus.io/companion

Note: The PLAYDECK Companion Module was developed by Semenov Nick. Visit his GitHub for the latest Module updates.

Start Companion, add a new connection and search for PLAYDECK to add the module:

Once connected, you can select typical PLAYDECK Actions to assign to Buttons, like CUE, PLAY, Start Overlay, and many more.


Insert YouTube Videos into Playlists

This article will show how to load and edit YouTube Videos.


Load YouTube into PLAYDECK

You can directly Drag Drop any YouTube URL from your Browser to PLAYDECK:

Or you can use the Stream Drag Drop Icon to paste/edit the URL:

Your YouTube Videos is ready to play out-of-the-box. The quality will be pre-selected dependend on your Playlist Vidoo Format and the Formats provided from YouTube.


Update YouTube Driver

Should the added YouTube Clip be shown as UNPLAYABLE/RED in PLAYDECK, please update the integrated YouTube Driver. Chances are, YouTube made changes to its platform and you need a newer driver from us:


Change Quality, Video and Audio

YouTube Videos are always available in different qualities. You can switch Video Tracks by right-clicking the YouTube Video:

Note: YouTube provides combined Video+Audio Tracks, which are much faster. If you switch to non-combined Video Track, caching can take much longer and seeking can desync video/audio.


Your PLAYDECK PC Build


PLAYDECK can be installed on any Windows 64-bit machine. This includes Windows Server Versions or Custom Cloud Builds.

PLAYDECK needs fast modern Hardware, if pushed to the Limit. It has to transcode any given Video Format and Framerate in Real-time into your selected Output Format. Ideally without any Frame Drops.

As with all Tasks, it all depends on your use case: Are you using the LITE Edition to operate one Full HD Channel in a Live Event for some Hours? Or are you using STUDIO to broadcast multiple UHD Channel to several receiver eg Streams, NDI, and all in a 24/7 manner?

One thing is certain: Without a powerful modern NVIDIA GPU you will likely be disappointed. Dont try to run PLAYDECK over a Intel Onboard GPU, it is not designed for that. Your NVIDIA GPU should have ideally at least a Score of 8000 on the Passmark Scale.

All other PC components should not be much older than 2 years, just to meet modern driver standards, as we update PLAYDECK at least 4 times a year with the latest driver. You will want to utilize and profit from that, as all PLAYDECK updates are free of charge, as long as you have a valid license.


Here a the Specs we use for our own PLAYDECK production builds:

  • BeQuiet Straight Power 11 750W
  • Gigabyte Z790 AORUS Elite AX So.1700 Dual Channel DDR5 ATX Retail
  • Intel Core i7 13700F 16 (8+8) 2.10GHz So.1700 TRAY
  • Noctua NH-U9S Tower Cooler
  • 32GB Corsair Vengeance black DDR5-5200
  • 500GB Samsung 970 EVO Plus M.2
  • 1TB Samsung 970 EVO Plus M.2
  • 12GB Gigabyte Geforce RTX 4070 Windforce OC Active PCIe 4.0 x16 (Retail)
  • Blackmagic Design DeckLink SDI 4K

Some additional informations about Hardware in relation to PLAYDECK:

Output Card

IF you use a dedicated Output Card (eg BM Decklink), you will not only offload ressources to the Card and reduce overall System GPU/CPU load, but you will also benefit from:

  • More “true” Colors
  • Nearly Zero Frame Drops due to Frame Rate Control
  • Overall higher Picture Quality
  • Much more stable than HDMI over Desktop (no Windows-interference)


We support Output Cards from these Manufacturers (see complete List):

  • Blackmagic Design
  • AJA
  • Deltacast
  • Bluefish444
  • DekTect
  • Magewell
  • Osprey
  • Stream Labs
  • Yuan
  • ASIO Devices (eg DANTE)


CPU Codecs, Keying and Alpha Channel

Please note, that these Video Codecs can not be decoded via GPU currently. PLAYDECK will fall back to CPU for these Codecs, so plan a strong CPU, if you use these Codecs regulary:

  • ProRes
  • HAP
  • DNxHD

If you are using Keying or Alpha Channel in genereal, and you do not need the extreme high quality of ProRes, try to use the HAP-A Codec instead. It will still be decodec on the CPU, but use alot less CPU power.


Notebooks

If you are aiming for mobile productions, we go with the Razor Blade Notebook and extend it with a Blackmagic Ultra Studio card via the thunderbolt interface. If in doubt, which manufactorer to go for, decide for a Gamer Notebook. Those are designed to run at maximum performance. Avoid buying Office-type Notebooks like Dell, which are designed for power saving and can seriously limit your playout performance.

Introduction


Thank you for choosing PLAYDECK! We are convinced that with PLAYDECK you will significantly increase your productivity, whether you produce live events, stadium TV, theatre performances, museums, TV broadcasts or virtual and hybrid streaming events. You can run PLAYDECK both on-site and cloud-based.

PLAYDECK provides you with 8 completely independent output channels in which you can organise your videos, graphics, audio files, live inputs, streams or YouTube clips simply by dragging and dropping.

PLAYDECK supports almost any codec and converts all content to the selected output format in real time. The output is completely flexible via dedicated output cards (e.g. from Blackmagic, AJA, Bluefish, …), via the extended desktop, via NDI or via Streams.

In the Studio Edition, your recording channel can be edited while the recording is still running (edit-while-ingest, e.g. highlight editing), played back with a time delay or streamed. For maximum flexibility you can choose from a wide range of different recording formats.

But PLAYDECK (depending on your licence) is much, much more than a simple playout system:
You can trim and crop your content, you can automatically adjust the volume, you can schedule the start of your contributions, you can control the playlist externally, you can start playback via your video switcher, you can transfer closed captions, you can completely customise PLAYDECK with advanced scripting functions, you can…

You are welcome to inform yourself about the incredible functionality of PLAYDECK in the following chapters. We are sure you will love it!

1 2