Ray5 Pilot - local dashboard/helper for Longer Ray5 users

I built a free local web controller/helper for Longer Ray5 engravers called Ray5 Pilot.

It is not a LightBurn replacement and it is not an official LightBurn plugin. It is a local companion dashboard for Ray5 users who want better visibility and control around the ESP3D/Ray5 web interface.

Main features:

  • Live Ray5 status using the ESP3D WebSocket interface
  • X/Y live machine position display
  • Manual jog controls
  • Pause, resume, and stop/abort controls
  • Unlock / Clear Alarm using M5 + $X
  • SD card file list, upload, start, delete, and refresh
  • Direct SD card upload from the dashboard
  • Imported job workflow: import, frame, upload, upload + run, and delete
  • Job framing from imported G-code bounds before uploading/running
  • Watched-folder import for .gc, .nc, and .gcode files
  • Camera stream proxy
  • Calibrated camera snapshot overlays for LightBurn/material alignment
  • Camera overlay alignment settings
  • Live console
  • Easy Settings page with descriptions and examples for setup/configuration
  • 3D-printer G-code safety scanner to help prevent accidental printer G-code uploads

It runs locally on Windows with Flask and defaults to 127.0.0.1, so it is intended for local use only.

I am looking for feedback/testers from other Longer Ray5 owners, especially different wattage models and firmware versions.

GitHub: GitHub - P0k3sm0t/Ray5-Pilot: Controller for the Ray5. · GitHub

Safety note: this controls a laser engraver. Always supervise jobs and verify behavior on your own machine before trusting any control software.

1 Like

Quick update: Ray5 Pilot v1.0.3 is now released.

This version is mostly cleanup and reliability work:

  • Fixed Test Fire behavior for the Ray5 using stationary M4 with PAGEID and forced M5 shutoff
  • Cleaned up the Camera card layout
  • Added camera video enable/disable with a placeholder image
  • Fixed the camera feed so it no longer overlaps the header
  • Moved G-code scanner settings into the Upload section
  • Cleaned up the Safety/Test Fire settings
  • Fixed /api/camera/snapshot
  • Improved watched-folder reliability
  • Kept the two-column Settings layout and Live Console raw command input improvements

GitHub:

As always, please test carefully on your own machine and use proper laser safety. Feedback, bug reports, and logs are welcome.

1 Like

Here are some screen shots!


Version 1.0.4 has been released.
Ray5 Pilot v1.0.4 focuses on file management, timelapse control, camera calibration accuracy, and safer dashboard behavior.

Highlights

  • Added multi-select file management for Imported Jobs, including Select All, Clear Selection, selected count, and Delete Selected.
  • Added multi-select file management for SD Card Files, including Select All, Clear Selection, selected count, and Delete Selected.
  • Added a full-width Timelapse dashboard card above the Video/Camera card.
  • Added Timelapse file listing, multi-select delete, selected count, and per-file Play controls.
  • Added Timelapse playback inside the existing top Video/Camera card.
  • Added manual Start Timelapse and Stop Timelapse controls.
  • Added automatic Timelapse arming for Imported Upload + Run and SD Card Start when Timelapse is enabled.
  • Added Timelapse Settings controls for enable/disable, snapshot interval, playback FPS, and image source.
  • Added Timelapse image source selection for either overlay-corrected snapshots or full raw camera frames.

Timelapse improvements

  • Manual Timelapse mode is now controlled only by the Start/Stop buttons.
  • Job Timelapse mode follows Ray5 machine state:
    • Run starts capture
    • Hold pauses capture
    • Run resumes capture
    • Idle stops and saves/builds output
  • Timelapse capture interval and playback speed are now separate settings.
  • Timelapse MP4 generation now uses playback FPS instead of treating the snapshot interval as frame duration.
  • Timelapse sessions now use stable session IDs.
  • Successful MP4 builds safely remove the matching session frame folder.
  • Deleting a Timelapse video also attempts to safely remove the matching session folder.
  • Timelapse messages now use one consistent bottom message line in the Timelapse card.

Camera and calibration fixes

  • Fixed embedded Camera Calibration click alignment when the calibration image is resized in the dashboard.
  • Fixed camera postprocess scale so values below 1.0 work correctly.
  • Improved postprocess scaling by applying source-area scaling before deskew when deskew is enabled.
  • Added camera capture locking to reduce race risk between manual snapshots and Timelapse captures.