From easy to expert, all in one 3D printing software - MatterContol lets you edit, organize and manage your 3D designs and your 3D printer. Created to help you get the most out of your 3D printer, MatterControl is opensource software available here. MatterControl has a dependency on the agg-sharp library, also by MatterHackers.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
AboutPage Improve DI, use constructor injection Jul 12, 2018
ActionBar Set default extrude amount to 10mm Aug 16, 2018
ApplicationView Revise export interface to support reporting Aug 18, 2018
Community.CsharpSqlite Remove ReleaseVersion line from .csproj files Mar 29, 2018
ConfigurationPage Add space between concatenated localization strings Aug 6, 2018
ControlElements Make sure we always send a response Jul 17, 2018
CustomWidgets Make angle correct Aug 18, 2018
DataStorage Consolidate application paths Aug 2, 2018
DesignTools Make casing match file system Aug 20, 2018
EeProm adding scroll to marlin eeprom window Jul 21, 2018
History Fix layout issue and runtime exception in PrintHistory view Jul 19, 2018
Launcher Remove ReleaseVersion line from .csproj files Mar 29, 2018
Library Revise export interface to support reporting Aug 18, 2018
MatterControl.OpenGL Use new Graphics2D.Render(IVertexSource) signature Aug 15, 2018
MatterControl.Printing Add GCodeFileStreamed(Stream) overload Jul 20, 2018
PartPreviewWindow Revise naming Aug 20, 2018
PluginSystem Remove ReleaseVersion line from .csproj files Mar 29, 2018
PrinterCommunication Revise export interface to support reporting Aug 18, 2018
PrinterControls Use current rather than abandoned naming, remove dead code Aug 13, 2018
PrinterDriverInstaller Remove ReleaseVersion line from .csproj files Mar 29, 2018
Properties Consolidate SHA1 helpers Mar 13, 2018
Queue Move PartSheetLogo into Images subdirectory Aug 7, 2018
SettingsManagement Get gifs working in markdown Jun 26, 2018
SetupWizard revert WrappedTextWidget to TextWidget Jul 18, 2018
SlicerConfiguration Revise export interface to support reporting Aug 18, 2018
StaticData adding wipe_tower_x description to all relevant settings Aug 17, 2018
Submodules fixing bug in MS Aug 18, 2018
Tests fixing test Aug 18, 2018
Tools Upgrade Roslyn Jul 29, 2018
Utilities Consolidate application paths Aug 2, 2018
VersionManagement Drop tracing unless specified at compile time Mar 22, 2018
.gitignore Add node/npm based precommit hooks for yaspeller-ci Jun 16, 2017
.gitmodules Took out the remotinglite dependency as we do not actually have it. Feb 27, 2015
.travis.yml Revise travis script Aug 11, 2018
.yaspellerrc Made FanControls values go from 0-100 Nov 2, 2017
App.config Upgrade framework to 4.7.1 Mar 22, 2018 Added contribution guidelines Dec 15, 2016
LICENSE Initial commit Jan 23, 2014
MatterControl Deployment Tests.cts Commit of the code Jan 30, 2014
MatterControl.csproj Convert MatterControl.csproj to PackageReference Aug 16, 2018
MatterControl.mac.nunit Add Mac nunit config file Jul 28, 2016
MatterControl.sln Getting MaterControl solution to build Aug 9, 2018
MatterControlApplication.cs Remove assembly validation as consolidated into MatterControl Aug 7, 2018
PdfSharp.dll Commit of the code Jan 30, 2014
Program.cs Init PlatformFeatures, ProcCommandLineArgs b4 ShowAsSystemWindow Aug 3, 2018 Fixed screenshot in README Jul 20, 2018
RootSystemWindow.cs Simplify title generation Aug 3, 2018
RunUnitTests.txt Commit of the code Jan 30, 2014
application.ico Only register FileSystemWatchers on Windows Jan 13, 2016
config.json Revise new hosting model Oct 5, 2017
desktop.ini Commit of the code Jan 30, 2014


Linux Travis CI-Master
Windows AppVeyor-Master

MatterControl is an open-source program designed to control and enhance the desktop 3D printing experience. It's designed to help you get the most out of your 3D printer - making it easy to track, preview, and print your 3D parts. Development of MatterControl is sponsored by MatterHackers and it's partners.




Release Notes

Building from Source

MatterControl is written in C#. It uses the agg-sharp GUI abstraction layer. See this wiki article if you want to contribute code.

  1. Checkout the latest source code and submodules:

     git clone --recursive
     cd MatterControl
  2. Install MonoDevelop and Nuget.

     sudo apt-get install monodevelop nuget
  3. Add Mono SSL Support - Copy in Mozilla Root certificates to enable NuGet and MatterControl SSL requests

     mozroots --import --sync
  4. Restore NuGet packages - On MonoDevelop 4.0 or older you can install NuGet Addin. If you are on Mint, also install libmono-cairo2.0-cil. Alternatively you can run the command line NuGet application to restore the project packages:

     nuget restore MatterControl.sln
  5. Optionally switch to a target branch

     git checkout master
     git submodule update --init --recursive

    As a single command line statement:

     targetBranch=master && git checkout $targetBranch && git submodule update --init --recursive
  6. Build MatterControl

     mdtool build -c:Release MatterControl.sln


     xbuild /p:Configuration=Release MatterControl.sln
  7. Link the StaticData from your source directory to the build directory

     ln -s ../../StaticData bin/Release/StaticData
  8. After MatterControl has been built in MonoDevelop it is recommended that you run the application via command line or via a shell script to invoke mono.

     mono bin/Release/MatterControl.exe

    If you'd like to log errors for troubleshooting

     mono bin/Release/MatterControl.exe > log.txt

    If you want detailed error logging and tracing

     MONO_LOG_LEVEL=debug mono bin/Release/MatterControl.exe > log.txt
  9. In order for MatterControl to access the serial ports, you will need to give your user the appropriate permissions. On Debian based distros, add yourself to the dialout group. On Arch, add yourself the the uucp and lock groups instead.

     gpasswd -a $USER dialout

Serial Helper

  1. Change to the SerialHelper directory

     cd Submodules/agg-sharp/SerialPortCommunication/SerialHelper
  2. Run the build script

  3. If your receive errors you may need to install libc6-dev-i386 for x86 compilation

     sudo apt-get install libc6-dev-i386

Help, Bugs, Feedback

For information on using MatterControl, check the MatterControl Wiki. If you have questions or feedback, feel free to post on the MatterHackers Forums or send an email to To report a bug, file an issue on GitHub.