The Text effect enables up to 20 lines of text, all individually controlled to be displayed. The content of the text can be static, but can also include countdown timers. Adding a '\n' to the text will display the text following it on a new line.





Contains the text that is to be displayed for the line.

From File

Set Text to be displayed from a local file.

From Lyrics

Set Text to be displayed from a Lyric Track.


Defines the font that is to be used for the text. Click on the attribute to open up a window where the type of font, style, size, color and other related attributes can be defined.

XL Font

Use an OS defined font or Select one of the xLights defined fonts. The xLights defined fonts are intended to match LOR SuperStar and may look better on models with lower pixel density.

Movement / C

Defines the direction of the movement of the line of text. One of several options are possible such as Left, Right, Down, None, etc.

If the box next to the Movement setting i.e. ‘C’ is checked, then the text will reach the center and stop.

When the Vector option is selected, the Start Position and End Position tabs at the bottom are used to adjust the motion. 0,0 is the middle position. It defaults to offsetting with the values being percentages of the model size but if you check the Offsets in Pixels box it becomes number of pixels.


Controls the speed at which the line of text moves.


Controls the layout of the line of text. The default is ‘Normal’, however other options to rotate the text at different angles are possible.

Count down

Defines whether the line of text is to be used as a Countdown Timer. The default value is ‘None’ indicating that it is not a Countdown Timer effect.

For a count down effect, the following options are possible and count down will be based from the time the effect is rendered or finally saved and not from when it is executed in the sequence. The concept of the count down timer stems from New Year’s Eve countdown displays. If one knows exactly when the countdown will start, then setting this to an appropriate date/time is a non-issue.

The date/time must conform the the RFC822 standard format.

Properly formatted examples are: Fri, 25 Dec 2015 00:00:00 +0100

Fri, 25 Dec 2015 00:00:00 EST

Fri, 25 Dec 2015 00:00:00 MST

Fri, 25 Dec 2015 00:00:00 -0800


These must be specified in the Text field without any quotes. seconds


Will execute a 100 second countdown

In the following examples ‘+0100’ refers to your time +GMT hours. Change accordingly. Or you can use GMT, EST etc.

to date ‘d h m s’

Fri, 25 Dec 2015 00:00:00 +0100

Will display 33d 3h 38m 14

to date ‘h:m:s’

Fri, 25 Dec 2015 00:00:00 +0100

Will display 3h 38m 14 - the time is calculated to the next day in hours, mins, secs

to date ‘m’ or ‘s’

Fri, 25 Dec 2015 00:00:00 +0100

Will display 217m - the time is calculated to the next day in minutes

to date ‘s’

Fri, 25 Dec 2015 00:00:00 +0100

Will display 13011 - the time is calculated to the next day in seconds

!to date !%tofmt

!Fri, 25 Dec 2015 00:00:00 +0100!%D

Will display 133


This setting is used to adjust the initial position of the text. Either the vertical (Y) or the horizontal (X) position of the text is adjusted, depending on the value of the ‘Movement’ setting. For a value of ‘None’ or a horizontal movement such as Left / Right, adjusting the setting will move the initial position of the text vertically.

Only the first line of text can be controlled vertically and horizontally. The other lines have a horizontal control only.

You can however use multiple Layers each with one or more text lines if required.

In order to stop the text after one cycle, use the "Vector" Movement option and define your vector motion. It will complete that motion in the duration of the effect. This option can also be used to stop text at a particular point on a matrix.

Text Replace

Specific "Keys" can be used to insert Sequence Settings Values into the text effect. These "keys" will replaced with the values specified in the Sequence Settings.

Replace KeySequence Settings Meta Data

${TITLE} or ${SONG}







Media File Name








Music URL



Last updated