How do I display a UDP message using a Live Text state in BrightAuthor?

Last Updated: September 18, 2014

Follow these steps to display and update Live Text fields using UDP messages:

1. In BrightAuthor, create the required number of User Variables: Go to the File > Presentation Properties > Variables tab and click the Add Variable button to create each user variable. Then click OK.


Note: In this example, three dots are used for the Default Value, but you can use whatever value you like.

2. Drag and drop a Live Text state onto an interactive playlist.


3. Select User variable for the item Type, then select the corresponding User Variable(“cell1” in this example).


4. Click Add Item to add more text widgets to the Live Text canvas, and then assign the remaining User Variables to these widgets. Click OK when you’ve added all the required widgets.


5. Under the Media Library > events tab, drag and drop the UDP Input event onto the Live Text widget.


6. In the UDP Input Event window, enter "<any>” (without the quotation marks) into the Specify UDP input field.

7. Select Transition to new state.


8. Under the Advanced tab for the UDP Input event, select the Assign input to variable? option and make sure that the Input specifies variable option is selected. Click OK.


Your playlist should look like this:


9. Publish the presentation to the player.

Sending UDP messages

You can use any application capable of sending UDP messages to display your UDP messages on screen.

This example uses Hercules to send UDP messages to the networked player(s) playing the above presentation.

  1. Open Hercules and go to the UDP tab.
  2. Under Module IP, enter the BrightSign player IP address and port 5000 (this is the default UDP sender and receiver port on recent BrightAuthor versions)
  3. Under the server settings make sure to deselect Server echo, Redirect to TCP Server, and Redirect to TCP client.
  4. At the bottom under the Send section enter “cell1:new message” and click Send to display “new message” on the BrightSign player. The string consists of "User Variable:the message".
  5. You can also use one UDP string to update multiple Live Text items at the same time. To do so, you need to separate each message with a “!!”. For example, you can enter “cell1:my message!!cell2:my other message!!cell3:yet another message” and click Send.


If you want to broadcast a UDP message to all the BrightSign players on the same subnet, you can replace the IP address of the player with a broadcast address such as “”.

See the link below for a BA project to get you started with testing:  

Have more questions? Submit a request


  • 1
    Brad Tripp

    Very Useful!

  • 0
    Scott Parker


    The issue is I need them to retain the info that has been sent from the Brightsign app, not return to a default value. The presentation runs for 30 seconds, then changes to another presentation, then starts again. When it starts again, it needs to pull the inputted information from the App.

  • 0

    Ok, in that case disregard what I had mentioned previously. In order to achieve what you're describing you'll just need to set the user variable Access value to shared (rather than Private which is the default value).




  • 0
    Scott Parker

    Thanks, but same issue. When the presentation restarts, it loads the default values (in this case the serial number of the player)

  • 0
    Scott Parker


    I've set up a presentation using this method. It is running a loop switching between 2 x presentations. Every time it restarts the presentation using the UDP commands, it loads with the serial number (or whatever it is set to start with in Presentation Properties)

  • 0

    Hi Scott,

    I don't remember exactly since when but all BA version above do allow adding a user variable with an empty Default value. You'll just need to select a user variable with a "Local" type and leave the Default value empty. In order to reset the user variable to its default value when the presentation restarts make sure to tick " Reset variables to their default value on presentation start".



Please sign in to leave a comment.
Can't find what you're looking for? Try to
Powered by Zendesk