Software Releases

From Nutcracker Wiki
Jump to: navigation, search

Nc-wiki2.jpg NOTE: The latest and all previous releases of xLights/Nutcracker for Windows can always be found in the links below. Nc-wiki2.jpg

xLights/Nutcracker Downloads


If this is an upgrade to an existing xLights/Nutcracker setup, make sure that you backup your existing files before installing a new version. The install process does delete any of the files required for your sequences or setup, as these files are kept in the show and media directories. Click Backup and follow the procedure to backup your existing files Menus or just press F10.

Windows Installation

  1. Download the required released executable file and save to any location on your Windows PC.
  2. Double click on the downloaded executable.
  3. The xLights setup Window will be displayed.
  4. Click on Next
  5. Select the destination location. Leave as is to upgrade to a new release. Follow the prompts and click on install when ready.
  6. Click on Finish to complete the installation

  • The xLights/Nutcracker software will be installed in the destination location.
    • In addition to the software required to run the application, the installer also installs a few useful utilities, dictionaries and a songs subdirectory.
  • The xLights/Nutcracker application software (32 bit) is installed by default in the xLights subdirectory within your Windows Program Files directory ( C:\Program Files\xLights\).
    • The location can be modified during the software install process by the user.

Macintosh Installation

  1. Double click on the compressed file that you downloaded.
  2. Drag the newly created folder containing the xLights/Nutcracker application and associated files to the location of your choice. The xLights/Nutcracker application software folder is created in the same directory as the downloaded file.

Linux Installation

  • Daily builds of xLights are available for Ubuntu 15.04 and newer at xLights Ubuntu PPA
    • To use open a terminal window and run:
      • sudo add-apt-repository ppa:chris-debenham/xlights
      • sudo apt-get update
      • sudo apt-get install xlights
  • If you are running something other than Ubuntu linux you will need to download from github and compile as per the included README.linux