Skip to content
Warning

This documentation is in active development. Content is being updated as feedback is reviewed. Your patience is appreciated.

Submit documentation feedback with the widget at the bottom-left of this window or by emailing [email protected].

Open a support ticket with the widget at the bottom-right or by emailing [email protected].

Errors and Messages

MillMage may display different notices, errors, or alarms when setting up a device, previewing operations, and operating your machine. These will be visible as pop up windows, icons next to settings, messages in the Notification Area, and messages in the Console Window.

This page contains information about the errors and alarms MillMage users may encounter, as well as links to additional resources for further troubleshooting. Search for your error message with the Find tool in your browser to find and jump directly to the message.

Note

Text in square brackets, such as [file name], is replaced with details about your project, file, or machine when the message appears.

Messages and Errors by Category

Operation Creation, Assigning, and Previewing

Project Setup

Message Window Title What It Means Potential Solution
Are you sure you want to cancel project setup? Confirm cancel? You clicked Cancel in the Project Setup wizard. Choose Yes to discard the setup, or No to keep working in the Project Setup Wizard.
Are you sure you want to cancel project setup? This will close MillMage Confirm cancel? No workpiece has been configured yet, and MillMage cannot open a project without one. Choose No and update or accept the project settings in the Project Setup window, or choose Yes to close MillMage.

Tool Library

Message Window Title What It Means Potential Solution
Category names must be unique. Cannot Rename Category Each category in the Tool Library must have its own unique name. Enter a name that is not already used by another category.
All tools contained in this category will also be deleted, do you wish to continue? Delete Category Deleting a category also deletes every tool in it. Copy any tools you want to keep before deleting, or choose No.
Failed to make copy of category. Duplicate Tool MillMage could not create a copy of the selected category. Try again. If the problem continues, restart MillMage and check that your Tool Library file is not read-only.

Tool Layers

Message Window Title What It Means Potential Solution
One of the selected shapes is assigned to an Operation and cannot be added to a Tool layer. Switch to Tool layer Changing the color of an object to either T1 orange or T2 light blue marks it as a tool layer. Tool layers help with placement, sizing, and manipulating designs and are never sent to your machine. Remove the shape from its operation first, or use a different color on the Color Palette.
You have manually placed tabs on the selected shapes and switching to a Tool layer will cause those tabs to be lost. Are you sure? Switch to Tool layer Tool layers cannot be used in operations, so they cannot keep operation-related information such as the retaining tabs used in Profile operations. Continuing removes the manually placed tabs. Choose No to keep the tabs, or use a different color on the Color Palette.
You already have manually placed tabs in the selected shapes and the new cut layer uses automatic tabs. You will lose the manually placed tabs. Are you sure? Switch to Automatic Tabs The selected shapes have manually placed tabs, but the operation you are moving them to is set to use automatic tabs in its Profile settings. Continuing replaces the manual tabs with automatic ones. Choose No to keep your manual tabs, or move the shapes to an operation that does not use automatic tabs.

Operations and Toolpaths

Message Window Title What It Means Potential Solution
There are no operations currently set to be output. Nothing to Output Every operation in the project has Output turned off, so there is nothing to send or save. Turn on Output for at least one operation in the Operations list.
Shapes were discarded for being out of bounds... Nothing to Output All of the shapes assigned to the output operations lie outside the workpiece and Workspace so they were removed from the job. Move the shapes inside the Workspace, or check that the project workpiece size in Project Setup matches your material stock.
The operation has no cached tool path. No Cached Tool Path A tool path is not currently cached. Turn on Output for at least one operation in the Operations list and Preview the results.
There are no shapes assigned to the operations that are set to be output. Nothing to Output The operations set to output do not have assigned shapes. Assign shapes to an operation, or turn on Output for the operation that holds your shapes.
Select one or more shapes and an operation Apply Operation You used Apply in the Operations Library without selecting shapes in the Workspace. Select one or more shapes, select an operation in the library, and then click Apply.
Warning: The operations library "[name]" was saved with a later version of the application. Newer Library Format The operations library was saved by a newer version of MillMage and may contain settings this version does not understand. Update MillMage to the latest version before using this library, or open the newer version if using pre-release builds.
Your device has an ATC enabled but at least 2 tools use the same tool number. Unable to proceed. Automatic Tool Changer Issue An Automatic Tool Changer (ATC) is enabled, but two or more tools in the job share the same tool number, so MillMage cannot tell them apart. Open the Tool Library and give each tool used in the job a unique tool number that matches its slot in your ATC.
Error while generating cuts (message text varies) Error while generating cuts One or more operations contain errors that prevent toolpaths from being generated. The message lists each affected operation and the reason. Open the listed operations and correct the reported settings, such as tool, depth, or stepover, then try again.
Troubleshooting (message text varies) Troubleshooting MillMage found potential problems with one or more operations while generating toolpaths. These do not stop the job, but the result may not be what you expect. Review the listed issues. Go back to correct them, or continue if the result is acceptable.
Shape must be assigned to an operation to convert properly Convert to bitmap Error A shape can only be converted to a bitmap after it has been assigned to an operation. Assign the shape to an operation, then convert it to a bitmap.

Preview

Message Window Title What It Means Potential Solution
Not enough memory to render Preview, your stock dimensions are too large for this PC Preview Error Your computer does not have enough free memory to build the 3D preview for the current stock size. Reduce the preview detail, reduce the stock dimensions in Project Setup, close other applications to free memory, or use a computer with more RAM.

Operations Export

Message Window Title What It Means Potential Solution
A preset named "[name]" already exists Save Operations Export Preset Export preset names must be unique. This also appears when renaming a preset. Enter a different name, or delete the existing preset first.
Are you sure you want to delete the preset "[name]"? Delete Operations Export Preset Confirmation shown before a user-created export preset is deleted. Choose Yes to delete the preset, or No to keep it.
Please select an export directory Export failed No folder was chosen to save the exported files to. Select an export directory, then export again.
The export directory '[folder]' does not exist Export failed The chosen export folder was moved, renamed, or deleted. Select an existing folder, or create the folder and try again.
MillMage was unable to write to '[file name]': [error details] Save failed MillMage could not write one of the exported files. The cause will be described in the error details. Check that the file is not open in another program, the folder is not read-only, and that the disk has free space.

File Management

Opening and Saving Projects

Message Window Title What It Means Potential Solution
Your project has been modified. Would you like to save before closing? Save Project? You are closing a project that has unsaved changes. Choose Save to keep your changes, Discard to close without saving, or Cancel to return to the project.
The file '[file name]' could not be found Project not found The project file could not be found at its saved location. It may have been moved, renamed, or deleted, or it may be on a disconnected drive. Use File → Open to browse to the file's current location.
This file was saved with a newer version of MillMage ([version]). It may not load correctly and saving it could cause data loss. Continue? Project created with newer version The project was saved by a newer version of MillMage. Some features may not load, and saving it in this version may remove data. Update MillMage before opening the file. If you continue, save under a new file name to protect the original.
Project file warnings (message text varies) Project file warnings: The project opened, but MillMage reported problems with some of its contents. The message lists each problem. Check your Documents folder for backups of your projects with _backup added to the file name.
It appears your last project wasn't closed properly, but we have a backup. Would you like to load it? Project: [project name] Restore File Found MillMage closed unexpectedly the last time it was used, and an automatic backup of the project was found. Choose Yes to load the backup, then save it under a new name.
You are about to import the vectors from another MillMage project into your empty project. This will lose the cut settings and import ONLY the shapes. Did you mean to 'Open' the project file instead? Import MillMage Project? You imported a MillMage project into an empty project. Importing brings in only the shapes, not the operations and settings. Choose Open to open the full project instead, or Import to bring in only the shapes.
The image file '[file name]' could not be found Image not found An image linked in the project could not be found at its saved location. Move the image back to its original location, or re-import it into the project. Make sure network drives are mounted and reopen the project file.
MillMage was unable to create '[file name]' Save failed MillMage could not create the file. This appears when saving projects and exporting files. Check that the folder exists and is not read-only, that the disk has free space, and that the file name is valid.
MillMage encountered an error when saving '[file name]' Save failed An error occurred while the project was being written to disk. Try saving to a different folder or file name, and check that the disk has free space.
MillMage was unable to remove the backup file '[file path]' Couldn't remove backup While saving, MillMage could not remove its temporary backup file. Check that the backup file is not open in another program and that the folder is not read-only. Your project may still have saved correctly.
MillMage was unable to write to '[file name]' Save failed MillMage could not write the G-code file when saving the job to a file. Check that the folder is not read-only, that the disk has free space, and that the file is not open in another program.

Importing Files

Message Window Title What It Means Potential Solution
Unable to open image '[file name]', file is possibly too large or corrupt Open failed The image could not be imported. It may be too large for available memory, or it may be damaged. Reduce the image size or resolution in an image editor, or re-save it in a common format such as PNG or JPG.
Unable to open image '[file name]', file is possibly corrupt Open failed The image could not be imported because the file appears to be damaged. Re-save or re-export the image from its original program and import it again.
MillMage doesn't recognize the extension [extension] in filename: [file name] Open failed MillMage does not support the file type you tried to import. Check the file extension, or convert the file to a supported format, such as SVG, DXF, AI, PDF, PNG, or JPG.
There was an error opening [file name] Open failed The file could not be opened. Check that the file exists on your computer, is not open in another program, and that you have permission to read it.
The import failed spectacularly. The crash has been averted, but we recommend that you save and restart MillMage. Import Crash An unexpected error occurred while importing. MillMage recovered, but may be in an unstable state. Save your project and restart MillMage. If the same file causes this again, re-export it from its original program.
An error occurred while reading: [error details] - on line [line], column [column] Error parsing SVG The SVG file contains invalid formatting at the line and column shown. Re-export the SVG from its original program, or open it in a vector editor and save a fresh copy.
This file does not appear to be an Adobe Illustrator file Unsupported file type The file has an .ai extension but its contents are not a valid Adobe Illustrator file. Re-save the file from Adobe Illustrator, or export it as SVG or PDF.
Unknown filter: [filter name] Maybe export as an image PDF Error The PDF uses a compression method that MillMage cannot read. Export the design from its original program as an SVG/vector file, or as an image if it is a raster design.

Art Library and Bundles

Message Window Title What It Means Potential Solution
A graphic with this name already exists - would you like to replace it? Entry already exists A graphic with the same name already exists in the Art Library. Choose Yes to replace it, or No and rename the graphic before adding it.
The selected shapes could not be added to your Art Library Could not update library The selected shapes could not be saved to the Art Library. Check that your Art Library folder exists and is not read-only, then try again.
Are you sure you want to delete '[name]' from the library? Delete Graphic? Confirmation shown before a graphic is deleted from the Art Library. Choose Yes to delete the graphic, or No to keep it.
Are you sure you want to delete the selected graphics from the library? Delete Graphic? Confirmation shown before several graphics are deleted from the Art Library. Choose Yes to delete the selected graphics, or No to keep them.
That name is already in use. Would you like to skip this file, rename it, or replace the existing one? Name already in use A file you are importing or copying into the Art Library has the same name as an existing entry. Choose to skip the file, rename it, or replace the existing entry.
Warning: This bundle was created with a later version of the application. Newer Bundle Format The bundle was made with a newer version of MillMage and may include content this version cannot use. Update MillMage to the latest version before importing the bundle.
Some vendor information fields are still empty Vendor Info Some vendor information fields in the bundle export are empty. Fill in the vendor information before exporting, or continue if it is not needed.

Design

Selecting and Editing Shapes

Message Window Title What It Means Potential Solution
Some shapes in your selection are locked. To delete, select the shapes, right-click, choose 'Unlock Selected Shapes' Then you can delete them as usual. Locked shapes Locked shapes cannot be deleted. Select the shapes, right-click, choose Unlock Selected Shapes, and delete them again.
No duplicate shapes found No duplicates found Delete Duplicate Shapes found no shapes that exactly overlap another shape. No duplicate shapes were found, so action is needed.
[number] duplicate shapes were found - would you like to delete them? Duplicates found Delete Duplicate Shapes found shapes that exactly overlap another shape. Choose Yes to delete the duplicates, or No to keep them.
No overlapping lines found No overlaps found Delete Overlapping Lines found no overlapping line segments. No action needed.
The selected object is either a group or bitmap You must select a basic closed path. Not a compatible shape Select Contained Shapes only works with a single closed path, not a group or image. Ungroup the shapes and select one closed path.
The selected object is either a compound shape or an open shape. You must select a basic closed path. Not a compatible shape Select Contained Shapes only works with a single closed path, not a compound shape or an open shape. Break apart the compound shape, or close the open shape, and select one closed path.
Some of the selected shapes overlap! Offsets will be applied to each shape individually, which may produce unexpected results. Consider using Boolean operations to combine overlapping shapes before offsetting. Intersecting Shapes Detected Some of the shapes you selected for Offset overlap each other. Each shape is offset on its own, which can produce overlapping results. Combine the overlapping shapes with a Boolean operation, or combine them with Weld or Union, before offsetting.
The selected layer is the same as the layer for the segment being cut. Are you sure you want to do this? Cut segment to new layer The operation chosen for the trimmed segment is the same one the segment is already in. Choose No and select a different operation, or Yes to continue anyway.
A virtual array cannot be of 1x1 size. If you continue, the virtual array will be removed. Are you sure you want to continue? Click Yes to continue and remove. Click No to return and alter the size. Invalid virtual array size A virtual array of 1 column by 1 row is not valid. Choose No to change the size, or Yes to remove the virtual array.

Nesting

Message Window Title What It Means Potential Solution
Select shapes and a target to nest into. Nesting Nesting needs shapes to nest and a target to nest them into. Select the shapes to nest, then add the target rectangle to your selection.
Select one or more shapes to nest into the target rectangle. Nesting Only one shape is selected. Nesting needs at least one shape plus a target rectangle. Select one or more shapes and the target rectangle, then try again.
Select a target to nest into Quick Nest Unsuccessful No target rectangle was found in the selection. Draw or select a rectangle to use as the nesting target.
Target rectangle must be axis aligned Quick Nest Unsuccessful The target rectangle is rotated. Quick Nest requires a rectangle with edges parallel to the X and Y axes. Rotate the target rectangle back to 0° or draw a new one.
Optimization yielded zero bounding box Quick Nest Unsuccessful Quick Nest could not find a valid arrangement for the selected shapes. Check that the selected shapes are valid closed shapes and that the target is large enough, then try again.
Some objects remain un-nested Quick Nest Unsuccessful Some shapes did not fit on the target, even after trying more sheets. Use a larger target, reduce spacing, or nest fewer shapes at a time.
Edge buffer is too large for the target rectangle True Nest Unsuccessful The edge buffer leaves no usable space inside the target rectangle. Reduce the edge buffer or use a larger target rectangle.
Some objects still remain unnested True Nest Unsuccessful Some shapes could not be placed within the target. Use a larger target, reduce the spacing or edge buffer, or allow rotation of the shapes.
The filename to import has been copied to the Clipboard. Click OK when nesting is complete. Waiting for nesting... The file to nest has been prepared for the external nesting tool, and its file name copied to your clipboard. Complete nesting in the external tool and import the result, then click OK.

Variable Text

Message Window Title What It Means Potential Solution
The CSV file had an error on line [line number] Bad CSV formatting The CSV file used for variable text has a formatting error on the line shown. Open the CSV in a text or spreadsheet editor, fix the line, and save it as a comma-separated file.
The CSV file was not found, or could not be opened CSV file not found The CSV file could not be found or opened. Check that the file still exists, is not open in another program, and select it again.

Fonts

Message Window Title What It Means Potential Solution
SHX Font directory unavailable or does not exist: [folder path] SHX Font Load The SHX font folder set in Settings cannot be found. It may have been moved, renamed, or be on a disconnected drive. Reconnect the drive, or update or clear the SHX font folder in Settings.
Are you sure you want to clear the SHX font directory? Confirm Clear SHX Fonts Confirmation shown before the SHX font folder setting is cleared. Choose Yes to clear the folder setting, or No to keep it.

Controlling Your Machine

Device Connection

Message Window Title What It Means Potential Solution
In order to perform this operation, you need to set up and select a device. No device selected This action needs an active device, but no device has been set up or selected. Set up a device or select an existing device.
You cannot change device settings without a device selected No device selected Device Settings can only be opened when a device is selected. Set up a device or select an existing device.
The machine does not appear to be connected to your computer No device found MillMage cannot find a connected machine. This appears when starting or sending a job. Check the USB or network connection, make sure the machine is powered on, and select the correct port in the Job Control Window.
The machine does not appear to be connected to your computer. Make sure it is plugged in, and any required drivers are installed. No device found MillMage cannot find a connected machine when starting the job. Check that the machine is powered on and plugged in, and that any required drivers are installed.
Please choose a communication port to connect to in the drop down that says '(Choose)' in the Device window. No communication port chosen No communication port has been selected for your machine. Select your machine's serial port from the (Choose) drop-down list in the Job Control Window.
Connection lost means that your USB connection was dropped, either by your controller, or your computer. This is relatively common and there are a number of things that can cause it. Would you like to see help on troubleshooting this issue? Connection Lost - Common hardware issue The USB connection to your controller was dropped by the controller or your computer. Common causes are electrical noise, long or low-quality USB cables, USB hubs, and computer power-saving settings. Choose to view the USB cable troubleshooting help. Try a short, shielded USB cable plugged directly into the computer, and turn off USB power saving: Windows 11, MacOS
ALARM:2 is a GRBL error that means you have tried to send your machine out of its usable work area, and the CNC controller has prevented this. You are currently not using 'Absolute Coords' as your 'Start From' setting, which could be the cause. Would you like to see help for this setting, to understand why? ALARM:2 - Common user error ALARM:2 is a GRBL alarm that means the machine was asked to move outside its usable work area and refused. Choose to view help on Alarm 2 and check your job origin.
There was an error reading the status information from the controller. (otherwise shows your controller's status) Controller Status Info Shows the status information reported by your controller, or an error if it could not be read. If an error is shown, check the connection to your controller and try again.
MillMage has detected that the braille service (brltty) is running on your computer. This can cause issues connecting with some devices. See the Troubleshooting page for more details on how to resolve this. Braille service running On Linux, the braille service (brltty) can take control of USB serial ports used by some controllers. Follow the troubleshooting steps to disable or remove brltty.

Jogging and Machine Control

Message Window Title What It Means Potential Solution
You have entered a zero move distance Move distance is zero The move distance is set to zero, so the machine will not move. This applies to the X, Y, and Z axes. Enter a move distance greater than zero.
The command to modify the coolant state is not defined in the device settings. Missing gcode command Device Settings does not include a G-code command to turn coolant on or off. Add the coolant commands for your controller in the Custom GCode tab in the Device Settings window.
The command to modify the vacuum state is not defined in the device settings. Missing gcode command Device Settings does not include a G-code command to turn the vacuum on or off. Add the vacuum commands for your controller in the Custom GCode tab in the Device Settings window.
The current position ([X] x, [Y] y) is outside the workspace. Are you sure? Coordinate out of bounds The machine's current position is outside the workspace, so setting it as the finish position may cause problems. Choose No and move the machine inside the workspace, or Yes if you are sure.
MillMage has previously auto-detected your origin position. Are you sure you want to change this? MillMage may no longer function correctly Origin change MillMage automatically detected your machine's origin, and you are about to change it. Choose No unless you are sure the detected origin is wrong.

Probing

Message Window Title What It Means Potential Solution
Setting the WCO for the Z axis requires also probing the tool length. Tool Length Probing Required To set the Z work coordinate offset, the tool length must also be probed. Continue with the probe wizard and complete the tool length probe.
Your probe block is not yet configured. Please configure it before proceeding. Unconfigured Probe Type The XYZ probe block has not been set up. Configure the XYZ probe block in the probe settings window before probing.
Your tool length probe is not yet configured. Please configure it before proceeding. Unconfigured Probe Type The tool length probe has not been set up. Configure the tool length probe in the probe settings window before probing.
Failed to send probe command. Probe X failed / Probe Y failed / Probe Z failed The probe command for the X, Y, or Z axis could not be sent to the machine. Check that the machine is connected, idle, and not in an alarm state, then try again.
Operation Cancelled. Tool Length Probe failed The tool length probe was cancelled before it finished. Run the tool length probe again.
Comms Error. Tool Length Probe failed Communication with the machine failed during the tool length probe. Check the connection to the machine and try again.
Failed to set TLO to machine. Tool Length Probe failed The probe finished, but the tool length offset (TLO) could not be sent to the machine. Check the connection and that your controller supports tool length offsets, then try again.
Invalid operation requested. Tool Length Probe failed The probe request was not valid for the current machine state or settings. Check your probe settings and that the machine is idle, then try again.
Operation timed out. Tool Length Probe failed The probe did not touch off in time. Check the tool length probe location in the probe settings window, and that the probe Search Z distance is long enough.
Operation failed. Tool Length Probe failed The tool length probe failed for an unknown reason. Check the probe wiring or switch travel/engagement, and look in the Console Window for details.
Cannot Apply Settings (message text varies) Cannot Apply Settings Some probe settings are not valid. The message describes the problem. Correct the listed setting, then click OK again.
Applying these settings will overwrite the current Tool Length Probe GCode block. Do you want to continue? Overwrite Tool Length Probe GCode Block? Applying the new probe settings will replace your existing Tool Length Probe G-code block. Choose No if you have customized the block and want to keep it.

Center Finder

Message Window Title What It Means Potential Solution
Not enough separation between points Unable to Calculate The points you set are too close together to calculate a center. Set points that are spread farther apart around the edge of the feature.
Unable to query the current position of the machine Communication failed MillMage could not read the machine's current position. Check that the machine is connected and idle, then try again.
Unable to calculate center Center Finder Failed The center could not be calculated from the points you set. Set new points around the edge of a circular feature, making sure they are not in a straight line.
Cannot move to calculated center Definition Error The calculated center is outside the machine's work area. Check your points and set them again.

Device Setup

Device Settings

Message Window Title What It Means Potential Solution
Invalid IP Address/Hostname Device Settings The IP address or hostname entered for a network device is not valid. Enter a valid IP address, such as 192.168.1.50, or hostname.
Support for the M7 command is not enabled in GRBL by default. This will result in errors unless your version of GRBL has support for this enabled. Are you sure you want to do this? Are you sure? Most GRBL controllers do not support the M7 command unless it was enabled when the firmware was built. Choose No unless you know your GRBL version supports M7.
Missing GCode for selected settings (message text varies) Missing GCode for selected settings One or more settings you enabled need a G-code block that has not been filled in. Add the listed G-code blocks, or turn off the settings that need them.
To prevent unsafe operations, the following misconfigured device settings have been disabled; [list of settings] They can be enabled again in the Device Settings menu, provided all GCode blocks are free from errors. Device Misconfiguration To prevent unsafe operations, MillMage turned off settings that depend on G-code blocks with errors. Fix the listed G-code blocks in Device Settings, then turn the settings back on.
You have set the working size of this device to [width] x [height] in device settings. Your firmware is reporting your actual axis travel as [width] x [height]. Having your device setup larger than your travel area may cause accidental crashes or limit errors. Device Size Mismatch The work area set in Device Settings is larger than the travel your controller reports. A work area larger than the real travel can cause crashes or limit errors. Choose to use the size reported by the firmware, or correct the work area in Device Settings.
If you ignore, you will disable Fetch configuration on connect. This will disable the warning, but also disable the dimension checks on this device profile. Are you sure? Are you sure? Ignoring the size mismatch turns off Fetch configuration on connect and the work area checks for this device. Choose No unless you are sure your Device Settings are correct.
One or more of the loaded settings are different than those in your controller. Would you like to write the new settings? Settings have changed Some machine settings in MillMage differ from those stored in your controller. Choose Yes to write the new settings to your controller, or No to discard them.
Editing vendor settings is potentially dangerous to you and your machine. Settings stored here can affect both operation and safety of the laser. Changes may result in damage to the machine, and/or its safety rating.By choosing to continue, you acknowledge that you understand this. Do you wish to continue? Safety warning Vendor settings control how your controller works and changing them can damage the machine or affect its safety. Continue only if you know what each setting does. Back up your settings first.
You are trying to use the same character for marking a comment and marking an escaped string. Please double check your inputs before attempting to generate gcode for your machine. We are resetting to the default. Escape character cannot match comment character The same character is set for both comments and escaped text in your custom G-code settings, so MillMage reset them to the defaults. Choose different characters for comments and escaped text.
The following blocks have changes. What would you like to do? [list of blocks] Overwrite GCode Blocks? Changing the G-code flavor will replace the listed blocks, which you have customized. Choose to keep your changes, overwrite them with the new flavor's defaults, or cancel.

Devices and Profiles

Message Window Title What It Means Potential Solution
The provided device profile has been imported as "[name]" and is now activated. Device Profile Imported A device profile file was imported and is now the active device. Check the device settings to make sure they match your machine.
Is this an X-Carve or Shapeoko CNC machine, or something else? If you are not sure, choose 'Other' X-Carve, Shapeoko, other? Asked during automatic device setup to apply settings for specific machines. Choose your machine type. If you are not sure, choose Other.
Two helper macros have been created for you in the Console window: 'Use Laser' will apply required settings to use your device as a laser. 'Use CNC' will reset the settings for CNC use. Helper Macros Created Two helper macros were added to the Macros Window for X-Carve and Shapeoko machines. Use Use CNC to restore CNC settings on your machine.
Failure loading icon file! Load Icon The icon image could not be loaded. Use a standard image file, such as PNG or JPG.
Icon size must be at least [size]x[size] pixels. Load Icon The icon image is too small. Use an image at least as large as the size shown.
Icon size must be smaller than [size]x[size] pixels. Load Icon The icon image is too large. Use an image smaller than the size shown.
The following macro shortcut keys have been cleared because they conflict with other shortcuts: [list of shortcuts] Macro Shortcuts Macro shortcut keys that conflicted with other shortcuts were cleared when the device loaded. Assign new, unused shortcut keys to the listed macros.
Are you sure you want to delete profile "[name]"? Delete Profile Confirmation shown before a profile is deleted. Choose Yes to delete the profile, or No to keep it.
Unable to delete the selected profile: [error details] Delete Profile Failed The profile could not be deleted. The error details describe the cause. Check that the profile files are not read-only or in use, then try again.
Unable to duplicate the selected profile: [error details] Duplicate Profile Failed The profile could not be copied. The error details describe the cause. Check that you have free disk space and permission to write to the profile folder.
You currently have unsaved profile changes. Save now? Save Profile Changes? Your profile has changes that have not been saved. Choose Yes to save, or No to discard the changes.

Running Jobs

Starting a Job

Message Window Title What It Means Potential Solution
Confirm Start (shows your device checklist) Confirm Start Your device has a checklist that must be confirmed before every job. The message shows the checklist items. Review each item, then click OK to start the job.
You have one or more shapes crossing the edge of the stock profile or outside of the stock profile completely. Skip these Shapes and Continue? Shapes crossing or outside of stock profile One or more shapes cross the edge of the material stock or lie completely outside it. Choose Yes to skip those shapes, or No and move them inside the Workspace.
I was unable to ask your device it's current Z height value, so the starting Z height will be the Material Height setting in the main cut list. Do you wish to continue? Could not connect to machine MillMage could not read the machine's current Z height, so the job will start from the Material Height in the main Operations list. Check that the machine is connected and idle. Continue only if your Material Height is correct.
Cut might be out of bounds - Start Cutting anyway? Cut out of bounds Part of the toolpath may go outside the machine's work area. Move the design inside the work area, check the job origin settings, or confirm the project material dimensions/stock size in Device Settings.
Cutting Tool Edge might be out of bounds - Start Cutting anyway? Cut out of bounds The toolpath is inside the material stock/work area, but the edge of the cutting tool may extend past it. Move the design farther from the edge of the material stock within the Workspace, or check the job origin settings.
You have no tool length probe configured. Please configure one now. Missing Tool Length Probe Your device is set up to use a tool length probe, but no probe has been configured. Configure your tool length probe in the probe settings when prompted.
Be absolutely sure your offsets are correct before choosing ignore. Otherwise choose Probe Now to go back to probing. Z Axis Probing Incomplete Z axis probing has not been completed for this job, so the Z offset may be wrong. Running with a wrong Z offset can damage the tool, workpiece, or machine. Choose Probe Now to probe Z. Choose Ignore only if you are sure your offsets are correct.
Ensure spindle has been started then click Ok to continue. Spindle Power Your machine is set up for manual spindle control. Start your spindle, then click OK to continue the job.
Your GCode configuration is set to emit tool changes and has tool length probe enabled. However the chosen gcode flavor does not support a single, continuous job with tool changes and a tool length probe. Do you wish to continue? Tool Probe Issue Your G-code settings output tool changes with a tool length probe, but the selected G-code flavor cannot run both in one continuous job. Choose a G-code flavor that supports this, or split the job by tool in the Export Operations Wizard.

Tool Changes

Message Window Title What It Means Potential Solution
Your job uses multiple tools, but your machine is not set up for tool changes with MillMage. Please disable all operations that do not use the current tool. Do you wish to continue? Multiple Tools Output Configuration Problem The job uses more than one tool, but your machine is not set up for tool changes. Disable all operations that do not use the current tool and run each tool as a separate job, or set up tool changes in Device Settings.
Your job uses more than one tool and you have 'Output Tool Change' selected but not 'Has Automatic Tool Changer' or 'Has Tool Length Probe' . Please check Device Settings to correct your machine configuration. Do you wish to continue? Multiple Tools Output Configuration Problem The job uses more than one tool and Output Tool Change is on, but neither Has Automatic Tool Changer nor Has Tool Length Probe is enabled. Open Device Settings and enable the option that matches your machine's hardware.
Your job uses more than one tool, but your machine may not be set up to handle tool changes: • 'Has Automatic Tool Changer' is not enabled. • Your 'Tool Change' block is still set to its default value. Tool changes will likely not occur during the job. Do you wish to continue? Multiple Tools Output Configuration Problem The job uses more than one tool, but no Automatic Tool Changer is enabled and the Tool Change G-code block has not been customized. Edit the Tool Change block in Device Settings to match your machine, or run each tool as a separate job.
Machine Status (message text varies) Machine Status Your machine has paused for a tool change. The message tells you which tool to install. Install the requested tool, and probe its length if needed, then choose to continue.

Framing

Message Window Title What It Means Potential Solution
[reason] Would you like to Frame All Operations instead? No Operations set to output No operations are set to output, so there is nothing to frame. This appears for both Rubber Band Frame and Bounding Box Frame. Choose Yes to frame all operations, or turn on Output for the operations you want to frame.
Cut might be out of bounds - Start Framing anyway? Cut out of bounds The frame may go outside the workpiece/material stock or outside of the Working Size. Move the design inside the Workspace, or check the job origin and Working Size in Device Settings.
There are no shapes assigned to the operations that are set to be output. Nothing to Output The operations set to output have no shapes assigned, so there is nothing to outline. Assign shapes to an operation, or turn on Output for the operation that holds your shapes.

Sending Files

Message Window Title What It Means Potential Solution
MillMage was unable to open '[file name]' Open failed The selected machine file could not be opened for sending. Check that the file exists and is not open in another program.
There was a problem sending data to the machine. The machine may be busy or paused. Transfer failed The job could not be sent to the machine. The machine may be busy running another job, paused, or in an alarm state. Check the machine's status, clear any alarms, wait for it to become idle, and try again.
There was an error writing files to a temporary directory for the transmission over the network. Writing Files Error MillMage could not write the temporary files needed to send the job over the network. Check that your computer has free disk space and that your temporary folder is writable.

During a Job

Message Window Title What It Means Potential Solution
You are currently streaming to your device. Are you sure you want to close? Confirm Close Closing MillMage while a job is streaming will stop the job partway through. Choose No and wait for the job to finish, or stop the job before closing.
Are you sure you want to abort the job? Abort Job? Confirmation shown before the running job is stopped. Choose Yes to stop the job, or No to keep running.

License, Updates, and Application Settings

License and Trial

Message Window Title What It Means Potential Solution
In order to continue using MillMage, you must accept the End User License Agreement. MillMage will now close. MillMage EULA MillMage cannot be used until the End User License Agreement is accepted. Restart MillMage and accept the agreement.
Trial activated - welcome to MillMage. Trial Activated Your free MillMage trial has started. Success! Extend your MillMage trial here.
Trial extension success! Trial Extension Your trial was extended. Success! Thank you for using MillMage! Visit MillMageSoftware.com to purchase MillMage Pro or MillMage Core soon.
There was an unexpected issue while extending your trial. Please send an email to [email protected] and include the Trial ID shown on the License Management window. It has been copied to the clipboard for you so you can paste it into the email request. Trial Extension The trial could not be extended. Your Trial ID has been copied to your clipboard. Email support with the Trial ID pasted into the message.
Success starting Pro trial! You may need to restart the application to see all changes. Start Pro Trial Your Pro trial has started. Restart MillMage if any features are missing.
There was an unexpected issue while starting your Pro trial. Please send an email to [email protected] and include the License key that has been copied to the clipboard for you so you can paste it into the email request. Start Pro Trial The Pro trial could not be started. Your license key has been copied to your clipboard. Email support with the license key pasted into the message.
You entered a license key without dashes (hyphens) - they are required. Incorrect License Format License keys must include the dashes (hyphens). Enter the key exactly as it appears in your purchase email, including the dashes. Copying and pasting avoids typing errors.
The key you entered contains special characters. A MillMage license is only letters from A to F, numbers from 0 to 9, and dashes. Incorrect License Format The key contains characters that cannot be part of a license key. Enter only the letters A–F, numbers 0–9, and dashes. Check for extra spaces or the letter O in place of a zero.
Your license has been activated - click Ok to start using MillMage. Product Activated Your license was activated. Success! Click OK to start using MillMage. Thank you for using MillMage!
The license activation failed - be sure your license key is correct. Activation Failed The license key could not be activated. Check the key, your internet connection, and that the key has not reached its activation limit.
MillMage will now close. Product Deactivated The license was deactivated on this computer, and MillMage will close. No action needed, or reactivate MillMage when ready.
An error occurred while attempting to deactivate the license. Deactivate failed The license could not be deactivated. Check your internet connection and try again, or use offline deactivation.
Your offline activation request has been generated. Email the request file with your license key to [email protected] to receive your offline activation key. Offline Request generated An offline activation request file was created. Email the request file and your license key to support to receive an activation file.
The offline request failed to generate - be sure you have enough space and write permissions to create the file. Offline Request failed The offline activation request file could not be created. Choose a folder you can write to, check for free disk space, and Request Offline Activation again.
You need to restart MillMage for new features to take effect. Product Activated The offline activation file was accepted. Restart MillMage.
The license activation failed - be sure to select the activation file that was emailed to you. Activation Failed The offline activation file could not be used. Select the activation file that support emailed to you.
Your offline deactivation request has been generated. Email the request file to [email protected] to complete the deactivation of this machine. Offline Request generated An Offline Deactivation Request file was created. Email the request file to support to finish deactivating this computer.
Offline deactivation has failed - the license on this machine is still active Offline deactivation failed Offline deactivation did not complete, and the license is still active on this computer. Try Requesting Offline Deactivation again, or contact support at [email protected].
The license key has expired. MillMage will continue to work, but you will need to renew the license if you would like to update the software to a newer version. License System Warning Your license key has expired. MillMage keeps working, but you cannot install newer versions. Renew your MillMage license to receive updates.
License System Error (message text varies) License System Error The license system reported an error. The message describes the problem. Check your internet connection and license key. Contact support if the problem continues at [email protected].
Making changes in the License screen will cancel the current job on your device. Continue? Device is working Changing the license while the machine is running a job will cancel the job. Choose No and wait for the job to finish.

Preferences and Settings

Message Window Title What It Means Potential Solution
You may not import preferences with an active project. Please select File > New from the menu and try again. Load Preferences Backup Preferences cannot be imported while a project is open. Select File > New, then import the preferences again.
Current preferences will be overwritten. Continue? Import Preferences Importing preferences will replace your current preferences. Back up your current preferences first if you may want them later.
You appear to be running a pre-release version of MillMage without existing preferences. However we have detected preferences from a release version. Would you like those release preferences transferred to this pre-release version? Preferences Transfer You are running a pre-release version with no preferences, and preferences from a release version were found. Choose Yes to copy your release preferences into the pre-release version.
Preferences have been transferred from: [folder] to [folder] MillMage will now continue to launch with these preferences. Preferences Transfer Your release preferences were copied to the pre-release version. No action needed.
This will reset all shortcut keys back to their original values. Are you sure? Are you sure? Resetting will restore every keyboard shortcut to its default. Choose No to keep your custom shortcuts.
MillMage needs to restart to apply changes. Would you like to restart now? Restart required MillMage must restart to apply display changes. Choose Yes to restart now, or No to restart later.
Apply Settings Change (message text varies) Apply Settings Change MillMage detected that your display settings may need changing so the interface displays correctly. Review the suggested change and choose whether to apply it.
Screen Resolution (message text varies) Screen Resolution Your screen resolution is lower than MillMage is designed for, so some windows may not fit. Use a higher resolution or lower display scaling if possible.

Support and Updates

Message Window Title What It Means Potential Solution
Support Data has been copied to the clipboard. Please paste into support ticket. Support Data Support information about your system and settings has been copied to your clipboard. Paste it into your support ticket.
Support data is from v[version] which does not match the version of this install. This may not work as intended! Support Data Instance The Support Data you are launching with was made by a different MillMage version. Use support data from the same version, or expect some differences.
The download will be handled by your browser. Please quit MillMage and run the installer when the download completes. Check version The update is being downloaded by your web browser. When the download finishes, close MillMage and run the installer.
Compatibility warning (message text varies) Compatibility warning MillMage found a known compatibility issue with your system or setup. The message describes the issue. Follow the guidance in the message.
This feature may provide access to or display third-party websites or services operated independently from LightBurn. … Third-Party Service Notice Shown before opening a Web Tool that uses a third-party website or service. Review the notice and choose whether to continue.

For more help using MillMage, please visit our forum to talk with MillMage staff and users, or email support.