Importing an xLights Sequence
The following example describes how to use this function to import an effects from an xLights XSQ/XML sequence.
- First ensure that you have created or opened an existing sequence that has the models added to the sequencer that you wish to import to. Note you must select a View first. If there are no models or groups displayed on the Sequencer, then you won’t be presented with any models to import to.
This process can be used to
- Import effects from a xLights sequence from another user
- Import effects from another of your (e.g. older) xLights sequence into an existing xLights sequence
Step 1
Create a new directory and unzip the sequence files to that directory. It is recommended to create this directory within your show folder. The zip file should contain the xlights_rgbeffects.xml, the sequence.xsq or sequence.xml and any other required files(image, shader, etc files). Change the show folder in xLights to point to the new directory. Copy the music file to the new folder if missing.
![](https://i2.wp.com/gblobscdn.gitbook.com/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LZSF7mvBH96k8ET5Lo0%2Fimage.png?w=1220&ssl=1)
Open the sequence, click on Render All and Save the sequence. You should be able to see how the lights flow in the layout window. Study the sequence and determine which models you wish to copy to your own models.
![](https://i0.wp.com/gblobscdn.gitbook.com/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-Lauul2SMjjkbyFWyD-B%2Fimage.png?w=1220&ssl=1)
Print out the model names from the shared sequence as you will need to know those when you import.
Look for the correct quantity of elements in the donor sequence that will match your elements. For example If you have 4 windows but the donor sequence has 8, pick the 4 windows that you want to copy.
Make a note of the names of each donor model you want to copy to a model of your own layout. Watch the sequence several times.
Step 2
Make sure you have the appropriate music file in your own media show directory. Close the sequence you were watching, go to the controller tab and change the show folder back to your own directories.
If importing into a new sequence, then
- Create a new musical sequence, select timings and add your display elements or select a view.
- Save the sequence.
Else
- Open the sequence you want to import into, add your display elements or select a view.
Ensure that your models are in your sequencer view before you start the import , else you won’t have any models to import into.
Select Import, Import Effects
Select the file type of XML by changed the dropdown at the bottom right. Select the donor sequence xLights XML.
A model mapping window is displayed. On the top left is a list containing the timing tracks to import. On the left are the models and model groups from YOUR layout/sequencer tab(“Model”). ‘Blue’ items are Model Groups. On the right is a list of models/groups/submodels (“Available”) that contain effects from the sequence being imported. Click and drag a model name from the right list to the ‘Map To’ column in the row that you want to import the model to. You may also highlight the “Map To” cell and double click on a “Available” model to map it or highlight a “Available” model and double click the “Map To” cell.
![](https://i1.wp.com/gblobscdn.gitbook.com/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-Ld5-zmWME8yDmHjXLbi%2Fimage.png?w=1220&ssl=1)
Models in the “Available” list will turn gray when used. These items can still be used multiple times even when grayed out.
![](https://i0.wp.com/gblobscdn.gitbook.com/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LpQh7mKzrWojxqFHvsE%2Fimage.png?w=1220&ssl=1)
When done, select “Save Mapping”, and save the XMAP file. This XMAP file can then be loaded in the future when mapping another sequence from the same layout.
![](https://i0.wp.com/gblobscdn.gitbook.com/assets%2F-LZ2Jwp7mRP9HqIZtQ_h%2F-M06a2WK47QZGo1kFc1g%2F-LZS6xH-tgJwtpE-igCU%2Fimage.png?w=1220&ssl=1)
Click OK when done.