-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Welcome to the Ray5 Pilot Wiki.
This wiki contains setup guides, feature notes, troubleshooting help, and workflow instructions for using Ray5 Pilot with a Longer Ray5 laser engraver.
Ray5 Pilot is a local web controller for the Longer Ray5 using the ESP3D-style HTTP/WebSocket interface. It includes dashboard controls, camera overlay tools, timelapse support, SD file management, machine settings, and workflow helpers for compatible laser software.
Start here if you are setting up Ray5 Pilot for the first time.
This guide covers:
- Installing requirements
- Starting Ray5 Pilot
- First-time Settings configuration
- Ray5 network setup
- Camera setup
- Imported Jobs
- Camera Overlay
- Machine Settings
- Basic troubleshooting
Open the Setup and Usage Guide
Use this guide to set up and adjust the Ray5 Pilot camera overlay system.
This guide covers:
- Setting up a camera feed
- Taking overlay snapshots
- Understanding raw vs processed overlay images
- Calibrating the overlay
- Adjusting X and Y source offsets
- Using scale to fine-tune the overlay view
- Testing alignment with a grid
- Using the processed overlay image as a reference in laser software
Open the Camera Overlay Configuration and Setup Guide
Use this guide to understand the Imported Jobs workflow and watched-folder auto-import.
This guide covers:
- What Imported Jobs are
- Manual import workflow
- Watched folder auto-import workflow
- Saving directly from laser software to the watched folder
- Frame, Upload, and Upload + Run
- Filename length notes for the Ray5 screen
- Rejected file behavior
- Best practices for job staging and cleanup
Open the Imported Jobs and Watched Folder Guide
Use this guide before reading, backing up, or changing Ray5/GRBL controller settings.
This guide covers:
- Opening the Machine Settings page
- Reading settings with
$$ - Downloading a backup
- Understanding the settings table
- Editing one setting at a time
- Saving changed settings
- Restoring a previous value
- Common GRBL settings
- Machine Settings safety warnings
Open the Machine Settings Usage Guide
Use this guide to understand how Ray5 Pilot fits with different laser design and G-code workflows.
This guide covers:
- General laser software workflow
- Exporting compatible G-code
- Work area and origin considerations
- Using LightBurn or similar laser software
- Using LaserGRBL-style workflows
- SVG/DXF design software plus G-code export
- Using Ray5 Pilot camera overlay images in other laser software
- Framing jobs before running
- Timelapse workflow with laser software jobs
Open the Laser Software Workflows Guide
Use this guide when something does not connect, load, move, upload, or behave as expected.
This guide covers:
- Ray5 connection issues
- WebSocket / PAGEID problems
- SD Card Files problems
- Imported Jobs problems
- File rejection
- Camera feed issues
- Camera overlay alignment
- Timelapse troubleshooting
- Machine Settings troubleshooting
- Manual Controls troubleshooting
- Config and browser cache problems
- Safe recovery steps
Open the Troubleshooting Guide
If you are new to Ray5 Pilot, use this order:
- Setup and Usage Guide
- Camera Overlay Configuration and Setup Guide
- Imported Jobs and Watched Folder Guide
- Using Ray5 Pilot With Different Laser Software Workflows
- Machine Settings Usage Guide
- Troubleshooting Guide
Ray5 Pilot controls a laser engraver. Always supervise laser operation, use proper eye protection, keep fire safety equipment nearby, and verify all settings and files before running a job.
Changing machine settings can affect motion limits, homing, acceleration, travel, and laser behavior. Back up your settings first and change only values you understand.
Do not expose Ray5 Pilot to the internet. The default local address is intended for local use.