Skip to content

Settings & Preferences

Customize Rayforge to match your workflow and preferences.

Accessing Settings

  • Menu: Edit → Preferences
  • Keyboard: Ctrl+,

General Settings

Appearance

  • Theme: Choose between System, Light, or Dark theme

Units

Configure display units for various values throughout the application:

  • Length: Millimeters, inches, and other length units
  • Speed: mm/min, mm/sec, inches/min, and other speed units
  • Acceleration: mm/s² and other acceleration units

Startup

Configure what happens when you start the application. Files specified on the command line will always override these settings.

  • Startup behavior:
  • Open nothing
  • Open last project
  • Open specific project
  • Project path: Path to the specific project to open on startup (only visible when "Open specific project" is selected)

Machines

Manage your machine configurations. See Machine Setup for detailed information on machine configuration.

  • Configured Machines: Add, edit, or remove machines from your list
  • Active Machine: The machine currently selected for use
  • Machine Status: Visual indicators show if a machine has an invalid configuration

Machine Settings Dialog

Each machine has its own detailed settings dialog with the following pages:

General

  • Machine Name: Display name for the machine
  • Driver Settings: Select and configure the machine driver
  • Startup Behavior:
  • Home On Start: Send a homing command when the application starts
  • Clear Alarm On Connect: Automatically send an unlock command if connected in an ALARM state
  • Axes & Dimensions:
  • Width: Width of the machine work area in mm
  • Height: Height of the machine work area in mm
  • X Offset: Offset to add to each gcode command on x axis
  • Y Offset: Offset to add to each gcode command on y axis
  • Coordinate Origin: The physical corner where coordinates are zero after homing (Bottom Left, Top Left, Top Right, Bottom Right)

Advanced

  • Output Settings:
  • G-Code Dialect: Select the G-code flavor for your machine
  • G-code Precision: Number of decimal places for coordinates (e.g., 3 for mm, 6 for µm)
  • Support Arcs: Generate G2/G3 arc commands for smoother paths
  • Arc Tolerance: Maximum deviation from original path when fitting arcs (in mm). Lower values drastically increase processing time and job size
  • Hooks: Configure custom hooks for machine events
  • Macros: Manage G-code macros for quick execution
  • Dialects: Manage available G-code dialects

Device

Read or apply settings directly to the connected device.

  • Read from Device: Fetch current settings from the machine
  • Device Settings: Edit device-specific configuration parameters

Device Settings

Editing these values can be dangerous and may render your machine inoperable! The device may restart or temporarily disconnect after a setting is changed.

Laser

  • Laser Heads: Manage multiple laser heads with their properties:
  • Tool number
  • Maximum power
  • Spot size (X and Y dimensions)

Camera

  • Cameras: Configure cameras for machine monitoring and alignment

Machine Hours

Track and manage machine usage:

  • Counters: Resettable counters for tracking various machine metrics
  • Reset Counter: Reset accumulated hours to zero
  • Edit Counter: Modify counter settings including notification thresholds
  • Remove Counter: Delete a counter from the list

Materials

Manage your material libraries and materials.

  • Material Libraries: Create and manage collections of materials
  • Materials: View and edit materials in the selected library

See Material Libraries for comprehensive coverage of the material system.

Recipes

Manage your saved recipes for different materials and processes.

  • Recipe Library: Access and manage your recipe collection
  • Material-Based Matching: Automatic recipe suggestions based on stock material
  • Step-Level Application: Apply and fine-tune recipes for individual operations

See Recipes for comprehensive coverage of the recipe system.

Packages

Manage installed packages and plugins.

  • Installed Packages: View all installed packages
  • Install: Add new packages from the registry
  • Update: Keep packages up to date
  • Remove: Uninstall packages that are no longer needed

Keyboard Shortcuts

Customize keyboard shortcuts for common actions. See Keyboard Shortcuts for the complete list.

  • Reset to Defaults: Restore all shortcuts to default bindings
  • Import/Export: Share shortcut configurations

Next: Features Overview →