Difference between revisions of "FAQs"

Is xLights Nutcracker Free?

• Yes. Both Matt and Sean have always believed their software should be made available free to the lighting community. The sources of xLights/Nutcracker is available to download from github. You can download the free sources from Sean's Github.

What platforms can xLights/Nutcracker run on?

• XLNC can run on Windows and MAC and Linux, systems. You can go here for the latest program release.

What do I need to install and run xLights/Nutcracker ?

• The software is self-contained , but utilizes the VAMP plug-ins to create timing marks such as beats and bars. Therefore it is recommended that you also install Audacity, though you don't have to, to utilize all the other functionality. Refer to the Installation chapter in the manual for details.

How do I get started ?

• Watch the Getting Started Tutorials
• Join the xLights/Nutcracker Forums and Groups
• Download xLights/Nutcracker
  • Nutcracker Software Releases for Windows
  • Software Releases MAC

My models are gone, where did they go?

• If you have any model groups selected (layout, select model groups), then ONLY those model groups will show on your layout screen. Uncheck all of those model groups and the rest of your models will re-appear.

Why don't my effects show on the preview after I've placed them on the model?

• Some effects require that you press F5 to update or that you render the sequence before you see them on the layout screen.

How do I do a chase effect - I don't see a chase effect icon

• Select a block of cells and hit 'd' for a fade down or 'u' for a fade up. To create the chase, highlight the block of cells, hold the ALT key and drag the lower right corner of the effect block to create the chase.

I can't seem to save and re-use my Effect Presets.

• Highlight the effects, right click, select Effect Preset. Ensure that you have your own Group created via Add Group, then click and add as a new preset. Create your own group - do not use Favorites or the default group.

Can I save my selected models so that I don't have to re-select them for each sequence?

• Use the View functionality to define the models and order you require in a View once. Then select that view when you open a sequence. Simple! . Refer to the Views section in the manual.

How do I get my models from one computer to another?

• All models are stored in the xlights_rgbeffects.xml file. Make sure computer B has that file copied over from Computer A and in the Show Directory folder configured on the setup tab.

I have a group of cells with a ramp effect, but I cant move them to form a chase.

• Highlight the effects , hold the ALT key and then drag the bottom right corner of the bottom-most effect in the highlighted group.

What happened to the Whole House Model (WHM)?

• The WHM feature was dropped because of the increased functionality with Model Groups. Get an equivalent WHM, just make a model group with all your models in it.

My Single Channel model (blue) wont turn on.

• Single Channel colors react only to the color that they are defined as.
  • If you define them as single color blue then it will only react to the blue channel. You can set any color and it will route the blue portion of that color to that model.
  • If you send White (R=255, G=255 B=255), to a single color blue model then it will turn fully blue. If you send blue it will turn fully blue. If you send red or green it won't turn on at all. If you send pink which is R=255, G=0, B=128 you will get a half brightness blue.
  • You can therefore include those single color models inside a group and they will react to the colors dropped on the group. Any of the "blue" components of the RGB values assigned to that model will cause it to fire at the associated brightness of the component.
  • The strings will light up with the intensity of the color for each channel. So if you send Purple R=128, G=0, B=128) , that will light up all the Red and Blue strings but only about 50% intensity.
• If you just want a string to turn on full brightness without worrying about it then use White

How can I use a model that someone else has shared in my sequence ?

• Since models are defined using xml, you can copy them into your xlights_rgbeffects xml file in the models section. Then update the channel assignment to your setup.

Use an editor that works well with XML such as Notepad++. Ensure that after you paste the xml, that the </models> end tag is returned to its original position on a new line.

I have sequences from LOR and LSP. How can I import them into xLights ?

• There are two ways of importing your sequences.
  • The most efficient way is to import the sequence as a data layer. You cannot edit the data imported, but you can layer effects on top of the data imported without affecting the imported data. The Nutcracker effect will play on the lights, however the imported data will not be touched.
  • The other way is to import effects. You can edit the sequence data imported. Refer to the Data layers and Import Effects sections in the xLights/Nutcracker manual.

I'm still using LOR for 8 controllers this year. How do I set them up?

• The general rule is that you can do 96 channels of LOR with xLights if the LOR controllers are in LOR mode. Your best bet would be to put the LOR controllers in DMX mode and then xLights can do it all. You can import all your LOR sequences, schedule them play them, edit them, etc.

I can't see a model on my Layout tab.

• Check the Layout/Model Groups window. If any model groups are selected, ONLY THOSE models will show on the layout window.
• Check that the model has the 'Part of my display' attribute ticked.
• If you are using Model Groups, check that the model is part of a group that has been selected via the Edit Groups window.
• You may need to drag the handles of the model from the bottom left corner of the Layout Window

Does xLights support Papagayo singing faces?

• Yes ,the 3.x functionality to import Papagayo PGO files is still available.
  • However, you can also create Singing Faces natively within xLights. Refer to the manual for details.

What media format is required for sequencing?

• Nutcracker currently only supports the MP3 format for audio files. Ensure that the MP3 file is saved with constant bit rate (CBR), preferably 128K or 192K. Use Audacity to export the audio as a constant bit rate file.

When using the xLights test tab, the colors don't match on my lights, why?

• The test tab pattern will always send in 'RGB'. To check the correct colors, create a small sequence, with ON red, then ON green, then ON blue, each of 5 secs or so and then click on Output To lights and run it from there. Alternatively, you can turn on channel #1. That will ALWAYS be Red.

How do I configure my P10 matrix panels ?

• Define it as a horizontal matrix.
• Set # of strings = number of rows on panels, # of RGB nodes per string = number of columns on panels and # of strands per string = 1. Starting corner = Top Left. Channel number as per your configuration (say 5800).
• Refer to the section on Configuring Matrix Panels as Models in the manual (next publication)