Launcher Options

Launcher Options

This page explains the ways to start Ray5 Pilot on Windows.

All launch methods start the same app. The launcher only changes how Ray5 Pilot is opened.

Option 1: Manual Python launch

Use this when troubleshooting because the console stays visible.

Open Command Prompt or PowerShell inside the Ray5 Pilot folder and run:

python app.py

Then open:

http://127.0.0.1:5050

Keep the terminal window open. Closing it stops Ray5 Pilot.

Option 2: BAT launcher

The release includes:

Start_Ray5_Pilot.bat

Use this for normal Windows startup when you want a simple double-click launcher.

The BAT launcher is useful because it shows startup errors in a console window. If the browser does not open or the app fails to start, read the BAT window first.

Option 3: EXE launcher

Some releases include:

Ray5 Pilot.exe

The EXE is a convenience launcher. It does not replace the Ray5 Pilot source files and does not change how the laser is controlled.

Desktop shortcut

You can create a desktop shortcut to the BAT or EXE launcher. Keep the shortcut pointing to the launcher inside the Ray5 Pilot folder so relative paths continue to work.

How to read launcher problems

Symptom	Meaning	Fix
Browser opens but page fails	App may not have started	Check the console window
python not found	Python is missing from PATH	Install Python or use full Python path
Module import error	Requirements are missing	Run pip install -r requirements.txt
Port already in use	Another Ray5 Pilot copy is running	Close the old console or change port
Window opens then closes	Startup crashed	Start with manual Python launch to see the error

Troubleshooting

If Ray5 Pilot will not start, use manual Python launch first. It gives the clearest error output.

If two browser tabs open, check whether both the launcher and the app are opening the browser. Use only one auto-open behavior.

If the app starts but cannot reach the Ray5, the launcher is not the problem. Go to Status Card, Settings, and Troubleshooting.