Send Debugging Information

From MatterControl Manual
Revision as of 09:27, 13 September 2017 by MatterHackers (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

MatterControl occasionally has issues (*gasp*), but there is often information you can collect which might tell us more about what the problem is. Send the appropriate files to, or upload them to a service like Pastebin and post them in our forum.

Crash Logs

These processes can be helpful for debugging crashes or issues with the MatterControl application itself.


The following steps could produce some error logs that might tell us more about what's going on:

  1. Right click on ‘My Computer’ and select ‘Manage.’
  2. In the menu on the left, navigate to ‘System Tools’ > ‘Event Viewer’ > ‘Windows Logs’.
  3. Click on ‘Application’ to show logs in the middle window pane, then click ‘Filter Current Log’ in the right window pane, then check ‘Error’ and hit ‘OK’.
  4. In the right window pane, choose ‘Save Filtered Log File As’. Give the file (should be in .evtx format) a descriptive name.
  5. Attach the .evtx file to an email to Describe the circumstances leading up to the crash.


If you are encountering a crash error on Mac follow the steps described below to generate a report:

  1. Close any open instances of MatterControl.
  2. Go to the 'Applications' folder.
  3. Locate the file.
  4. Right-click and select "Show Package Contents".
  5. Navigate to 'Contents' > 'MacOS'.
  6. Double click the 'MatterControlMac' file (this will open a terminal window and start the application).
  7. Copy the output.
    If MatterControl crashes upon startup copy the message that appears in the terminal window immediately.
    If the crash is triggered by a specific event, recreate the event and then copy the message that appears.
  8. Send the error message to along with a description of the steps that cause the issue.


Run MatterControl from a terminal. Copy all output and send it to

Other Useful Files

Model File

The STL or AMF file you are trying to print using MatterControl.

Slice Settings

The Profile... Menu

These are all of the settings that define how your object is to be printed. If you are having trouble getting good results, we may ask you to export all of your settings and send them to us so we can give you recommendations.

  1. Go to the Settings page.
  2. On the right side, underneath the MATERIALS preset selection, there is a drop down menu that says 'Profile...'. Open this menu.
  3. Select 'Export'
  4. Choose 'MatterControl'
  5. Save the file.

G-Code File

These are the instructions generated by the slicer, which will be sent to your printer. If your object is not being printed correctly, we may ask for this file.

  1. Open your object in 3D VIEW.
  2. Click the 'Export' button at the bottom and select 'Export as G-Code'.
  3. Save the file.

Print Log / Terminal Log

The G-Code Terminal window, shown here after establishing a connection to a Rostock MAX V2.

This log details all the communications between MatterControl and your printer. It is helpful for diagnosing hardware/firmware errors and communications issues.

It is important to note that reconnecting to the printer will clear the previous print's log, so make sure you export the file before you attempt to do so.

  1. Run a print as you normally would.
  2. Once the problem occurs, open the G-Code terminal by going to Options > Show Terminal.
  3. Click the 'Export' button at the bottom of the screen.
  4. Save the print log.

Build Number

MatterControl Desktop


  1. HELP menu
  2. About MatterControl
  3. All the way at the bottom: 'Build 1.___________' i.e. Build -- the last four numbers are what's important

MatterControl Touch and T10


  1. ABOUT
  2. All the way at the bottom: 'Build 1.___________' i.e. Build -- the last four numbers are what's important