DTMF Input plug-ins

DTMF input is setup if X-Pert Playout receives a DTMF signal.

There are several Input sub-plugins for reading the DTMF tones, depending on the audio device, which receives the signal.

In the Input Plug-in tab select the receiving audio device. Currently, there are three options: Sound Card Input, UDP Mpeg Input, and DeckLink Input.

          After selecting the DTMF Input from Modules list, press the Configure button to open the configure dialog. Here you can select the desired live input, as configured in the Live Inputs Editor. The device, to which the input is connected is written next to it. Select the Audio Type and audio Channels from the fields below.

Sound Card Input

          This plug-in is to be used for analog audio tones, received on your PC sound card (coming from an IRD, for example). Select this line and press Assign to load it. Then, press Configure to select the sound input device and configure it:

 Mono – select it if the incoming signal is mono;

 Left – select it if the incoming audio signal is stereo, but you would like X-Pert Playout to read only the tones, coming in the left channel;

 Right – select it if the incoming audio signal is stereo, but you would like X-Pert Playout to read only the tones, coming in the right channel.

UDP MPEG-2 Input

This plug-in decodes DTMF tones that come through UDP in the MPEG2 Transport Stream.

          Select the UDP Mpeg input from the DTMF plug-in list and press Assign. Then, press Configure to specify the source of the cue tones (Host IP Address and Port), and the Stream ID. The DTMF tones could come in three different ways:

 Analog DTMF – the cue tones arrive as a separate audio stream in the TS. The PID of this stream should be entered in the Stream ID box.

When the Analog DTMF is selected, to the left you can specify the source audio channel.

 Digital Cable (DVS-253) – the US implementation of digital signaling for splice points, the points are described in SI tables.

 Digital TV (SMPTE-312M) – the European implementation of digital signaling for splice points, the points are described in SI tables.

          After configuring the plug-in, click OK and go to the Commands tab. It contains all possible actions that can be executed upon receiving a certain DTMF sequence. Please, check the details further in this section.

DeckLink Input

          This plug-in allows for reading DTMF tones, embedded in an SDI video signal, or coming through the analog audio inputs of a Blackmagic DeckLink board. Select it in the plug-ins list and press Assign.  Then, click on Configure to setup the input.

If there are more than one DeckLink boards installed on your system, please choose which of them to use for capturing the cue tones.

NOTE: You cannot use the same DeckLink board for DTMF capturing and playback at the same time!

          Below you can select which audio pair contains the cue tones and whether they are coming in the  Left or in the  Right channel. Click OK to save your settings.

When you are ready with the plug-in setup, you can go to the Commands tab to create the necessary presets.

In this tab you have to specify what X-Pert Playout should do upon receiving a certain sequence of DTMF tones.


Enter a Name for the command and specify the DTMF sequence that will trigger it. Then, select what should happen upon receiving this tone sequence in the Command drop-down list. Most commands are self-explanatory, but there are several that need to be clarified:

Jump to / Cue to – when assigning this command, you have to specify the Clip number, to which it refers.

Reset – resets the master counter in the main X-Pert Playout window (equal to stop & play command). This event is executed between two clips and does not affect the playback.

Hardware reset– resets the hardware platform!

WARNING! This command will interrupt the playback! After resetting the hardware, X-Pert Playout will remain in Stop mode!

Cue – same as the Cue button in the main X-Pert Playout interface, this command will pause the playback on the first frame of the currently selected clip in the playlist.

WARNING! This command will interrupt the playback!

Jump to bookmark in time range – this command applies only to bookmarks that have some Time zone specified in their properties. X-Pert Playout will not care about the bookmark’s names. There are two possible occasions when working with this command:

If the cue tone arrives within the Time range, specified in the properties of any bookmark in the playlist, X-Pert Playout jumps to the relevant bookmark according to the current system time.

If no bookmark in the playlist has a Time range that includes the time of arrival of the cue tone, X-Pert Playout ignores the command.

IMPORTANT: Please, make sure not to create bookmarks with overlapping time zones. Otherwise, X-Pert Playout will jump to the first bookmark in the playlist that is assigned for the relevant time zone.

Jump to bookmark – this command uses bookmarks’ names for reference. You must specify the Bookmark name in the string below, so X-Pert Playout would “know” where to jump to.

There are two possible occasions when working with this command:

1) If there is a Time range specified in the bookmark’s properties, and:

the tone arrives within the time range =>X-Pert Playout will jump to this bookmark

a trigger arrives outside the time range =>X-Pert Playout will ignore the command

Thus, you can have more than one bookmark in the playlist that is assigned for the same time range.

2) If there is no Time range, specified in the bookmark’s properties, X-Pert Playout will jump to that bookmark unconditionally upon receiving the trigger tone.

Please, check the Bookmarks description in the Edit menu section above for more details.

Offset – use this spin-box to postpone the execution of the specified command. The value here is in milliseconds!

NOTE: This string can contain only positive values!

WARNING! All DTMF sequences (strings) must have the same length! Otherwise, make sure that longer sequences do not comprise some of the shorter sequences! Otherwise, we cannot guarantee the correct execution of the assigned commands.

TIP (!) You can save your DTMF commands settings in a file. Thus, you can load them on other servers without having to configure the same settings numerous times.

          Press the  Save button to save the settings. To load them on another server, copy the settings file (*.dts) to it. Then, open Settings  Modules  Remote  DTMF Plug-ins configuration and press the  Load settings button. Browse for the *.dts file and click Open. Press  if you need to apply some changes on currently selected preset with DTMF Properties. To delete already saved settings, click on the needless row and press . To create new row settings simply press .