How to use on Windows

Portable package — extract, click, and use. No installation needed.

Download the package

Go to the GitHub Releases page and download the referee-lights-windows.zip file from the latest version.

Extract the ZIP

Right-click the downloaded file and choose "Extract All". Pick an easy-to-find folder like the Desktop or C:\referee-lights.

Run Iniciar.cmd

Open the extracted folder and double-click the Iniciar.cmd file. Two terminal windows will open — one for the server and one for the frontend. Do not close them.

Open in the browser

After a few seconds, open your browser and go to http://localhost:3000. The admin panel will appear. Create a session and share the QR Codes with the referees.

Connect the devices

Referees must be on the same WiFi network. They access via the machine's IP address (e.g., http://192.168.1.100:3000) by scanning the QR Code.

Requirements

✓Windows 10 or later (64-bit)
✓No installation needed — Node.js is included in the package
✓WiFi network to connect referee devices
✓Modern browser (Chrome, Edge, Firefox)

Common issues

Windows blocked Iniciar.cmd

Click "More info" then "Run anyway". This is normal for files downloaded from the internet.

The page won't open in the browser

Wait 10 to 15 seconds after running Iniciar.cmd. If it still doesn't work, check the terminal windows for errors.

Referees can't connect

Make sure everyone is on the same WiFi network. Use the machine's IP (shown in the admin panel) instead of localhost.

Port already in use error

Close other applications using ports 3000 or 3333, or edit the .env file to change the ports.

Download for Windows