Skip to main content

Settings

General Settings

Customize Rayforge to match your workflow and preferences. Open the settings dialog via Edit → Settings or press ctrl+comma.

General​

The General page contains application-wide settings.

Appearance​

Choose between System, Light, or Dark theme to match your desktop environment or personal preference. You can also configure Operation Colors to use either the laser color or the layer color for visual distinction on the canvas.

Shop mode replaces the bottom panel's Controls tab with a touch-friendly control surface: large per-axis position readouts with zero buttons, an offsets card, oversized jog speed/step steppers, and a grid of large jog and job buttons. It is meant for operating the machine while standing at it, and is disabled by default.

Units​

Configure the display units used throughout the application. You can set separate units for length (millimeters, inches, etc.), speed (mm/min, mm/sec, inches/min, etc.), and acceleration (mm/s², etc.).

Behavior​

By default, operations are recalculated automatically after every change. If you work on a slower machine or with very complex documents, you can disable Auto-update operations and trigger recalculation manually via the toolbar button instead.

Rayforge can Check for updates automatically on startup. When enabled, you will be notified when a new version is available.

Rayforge can also Check for addon updates automatically on startup. Disabling this does not prevent manual checks from the Addons page.

With Watch imported files enabled, Rayforge monitors the files behind imported workpieces and offers to reload them when they change on disk. See Keeping Imported Files in Sync for details.

You can also configure Startup behavior — start with an empty workspace, reopen your last project, or always open a specific project file. Note that files specified on the command line will always override these settings.

Privacy​

Rayforge can send anonymous usage data to help improve the application. No personal information is collected. You can toggle Report Anonymous Usage on or off at any time. See the usage tracking page to learn more about what data is collected and how it is used.

Mouse Gestures​

Mouse Gestures settings

The Mouse Gestures page lets you rebind the navigation gestures of the 2D canvas and the 3D canvas; the sketch editor uses the same gestures as the 2D canvas. Each row offers a dropdown with the available mouse button combinations:

  • 2D Canvas — Pan the view (middle drag by default; on the left mouse button the drag is reserved for selecting, so it is not offered).
  • 3D Canvas — Orbit the camera (middle drag), Pan the camera (Shift + middle drag) and Rotate around the Z axis (left drag).

Zooming (mouse wheel), the context menu (right-click), and resetting the view (the 1 key on the 2D canvas) are fixed and cannot be changed. A plain click on a bound button still performs its fixed action: when panning is bound to the right mouse button, right-dragging pans and a plain right-click still opens the context menu. Selecting Unassigned disables a gesture, and combinations already used by another action of the same canvas are not offered. Addons can contribute additional gesture configurations, which appear as extra sections on this page.

Other Settings​

The settings dialog also includes pages for managing other parts of the application. Each has its own dedicated documentation:

  • Machines — add, remove, and configure your laser cutters
  • Materials — manage your material libraries
  • Recipes — manage saved operation recipes
  • Color Rules — map SVG colors to step types
  • AI Providers — configure AI providers for use by addons
  • Addons — install, update, and remove extension addons