Video and Camera

Video and Camera

The Video / Camera card shows the camera stream, controls snapshots, opens the popout video window, and launches overlay calibration.

Buttons

Button	Use
Reload Camera	Reload the video stream
Test Camera	Test whether Ray5 Pilot can reach the configured camera URL
Calibrate Overlay	Open Camera Overlay Calibration
Open Video	Open the camera stream in a popout window
Disable/Enable Video	Stop or resume live video on the Dashboard
Take Snapshot	Capture latest processed and raw snapshot
Open Folder	Open the snapshot folder
Open Latest	Open the latest processed overlay image
Open Raw	Open the latest raw camera image

Snapshot files

Ray5 Pilot normally keeps current snapshot outputs such as:

latest.jpg
latest_raw.jpg

The processed image is used for overlay/reference workflows. The raw image is the unprocessed camera frame.

When the live preview is active, Ray5 Pilot tries to save snapshots from the latest live preview frame first. This avoids opening a second camera/RTSP connection just to take a still image. If no fresh live frame is available, Ray5 Pilot falls back to the configured camera capture method.

Processed vs raw

• Processed uses deskew, final size, DPI, rotation/processing, and overlay guides when enabled.
• Raw is the full camera frame without overlay correction.

Popout video

Open Video moves the live stream into a separate window. This is useful when you want the camera visible while working in another app.

If the popout is active, the Dashboard video area may show that the stream is popped out.

Cross-platform notes

Opening the snapshot folder uses the operating system's normal file/folder opener:

• Windows: Explorer / os.startfile behavior.
• macOS: open.
• Linux: xdg-open.

If Open Folder does not work on Linux, confirm xdg-open is installed and that you are running a desktop environment that can open folders.

RTSP camera URLs are kept exactly as entered in Settings. Ray5 Pilot handles ffmpeg fallback at runtime and masks camera credentials in logs where possible. Do not share full camera URLs or unredacted logs publicly.

Troubleshooting

Problem	Fix
Camera unavailable	Check camera URL in Settings
Test Camera fails	Confirm camera is powered and reachable in a browser/VLC
Video disabled	Click Enable Video
Open Latest shows old image	Take a new snapshot
Overlay is distorted	Recalibrate overlay points
Overlay is close but shifted	Use Camera Overlay Alignment settings
Timelapse uses wrong view	Change Timelapse image source in Settings