Looking to try out LX Studio? Start here!

How to set up an LX Studio development environment

Install the compatible Java SDK

Current version is Java 17 Temurin, available for download from:

https://adoptium.net/

Install the eclipse IDE

https://www.eclipse.org/downloads/

Clone the LXStudio-IDE git repository

Open Terminal and clone the git repository to your eclipse working folder:

cd ~/eclipse-workspace
git clone https://github.com/heronarts/LXStudio-IDE.git

Add the project to eclipse

In eclipse, open the project from filesystem (alternatively, Import Project should also work):

File -> Open Projects From Filesystem
Click Directory...
Choose ~/eclipse-workspace/LXStudio-IDE
Click Finish

Add a run configuration

Under Package Explorer in the left pane, right-click the LXStudio-IDE project and choose Run As -> Java Application

Select LXStudioApp, click OK.

The first run attempt will fail. Go to menu item Run -> Run Configurations...

Select LXStudioApp on the left

Select the tab "(x)= Arguments"

Under VM Arguments, add:

-XstartOnFirstThread

Click close.

Run it

Select the project in the Package Explorer

Go to menu item Run -> Run, or click the green Play icon in the menu bar.

If you see the LX Studio window, you did it!

Next Steps

Wiki todo: UI tutorial: Add a strip fixture to your model, Add a channel, Add a pattern.

Wiki todo: Write your own pattern in java.