ukashek/ledfx-workshop

Start LedFx first. The default LedFx address is usually:

http://127.0.0.1:8888

Windows One-Click Start

On Windows, double-click LedFx Workshop Launcher Windows.vbs. It starts the local Workshop server in the background and opens your browser automatically.

If Windows blocks the hidden launcher or you need to see startup errors, double-click LedFx Workshop Launcher Windows.bat instead.

The Windows launcher uses .venv\Scripts\python.exe when it exists, then falls back to the Python launcher py.exe -3, then python.exe.

macOS One-Click Start

On macOS, double-click LedFx Workshop Launcher MacOS.app in this folder. It starts the local Workshop server in the background and opens the browser automatically.

If macOS blocks the app the first time, right-click it and choose Open. The fallback one-file launcher is LedFx Workshop Launcher MacOS.command.

The launchers use http://127.0.0.1:8057 when it is free, then pick the next available local port. Logs are written to ledfx-workshop.log and ledfx-workshop-error.log.

Terminal Start

You can still start Workshop manually:

python3 -m src.server

Open the URL printed by the server.

Optional virtual environment:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 -m src.server --port 8057 --ledfx http://127.0.0.1:8888

On Windows PowerShell:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python -m src.server --port 8057 --ledfx http://127.0.0.1:8888