Everybody knows about most popular firmware for various 3d printers named as Marlin Firmware. Its ability is so wide and extends quickly due to a lot of people working about it.

Huge amount of options and abilities confuses everybody, who sees it at first time.

For simplifying and speed-up configuration process with the firmware - I want to introduce this tool

It works on Windows, Mac OS, Linux (.deb and .AppImage)

Step 1: Installation

1. Go to the github releases page and download file for your operation system

2. There is one dependency for work it is GIT . It must be installed before with default configuration, if you don't have it

Step 2: Running

At first You need just any empty folder(on your desktop or home folder - do not use a name folder "Marlin" !!!) where will be deployed the marlin repository.

Then run the marlin-conf application and choose this folder, after selecting folder it will download the firmware (it can take a minute - real size of repository about 50 Mb)

At second run you can select the same folder and it will be faster, because will be used previous downloaded repository

Step 3: Uploading Your Previous Configuration

There are two ways upload your previous configuration: drag these files into browser or open these from from folder on the disk using 'Upload' -> 'Files' button

Step 4: Customizing

There are four tabs in this application and each has sections

For quick navigation you can use right sided navigation bar

Each line has yellow button with sigh '?' at the end - which can help you to understand the option

Also helpful can be 'G-codes' tab

Step 5: Compilation and Uploading Firmware

If you have installed Arduino and like this project - just open from it this folder and do it

But here is another way to compile and firmware your hardware is PlatformIO project which support a lot of platforms and IoT devices and do it quickly

After its installation, described on project page and restarting marlin-conf application, you can press 'Compile' button and all packages and libraries will be downloaded and installed automatically

If compilation is succeeded - press 'Flash' button to firmware your device

Step 6: Interacting With Printer

This step can be used at any time(without customizing and flashing)

Press 'Consoles' button - and in new window you get list of your serial ports with ability to select speed and open it

Also you can use 'Command' helper to operate with printer's head - it so usable when debugging hardware and firmware

On main page of application is the tab with G-codes - It can help you too



    • Trash to Treasure

      Trash to Treasure
    • Tape Contest

      Tape Contest
    • Arduino Contest 2019

      Arduino Contest 2019

    13 Discussions


    Question 3 months ago

    why dont anet v1 show up under boards so i can upload?can anyone give me a step by step how to do this?i cant get it to upload ether using arduino as well


    4 months ago

    I have the same questions as pseakins but it looks like the author is not supporting this. It's a sham because it looks very useful, just not enough of an explanation on how to actually use it. I can open up my current "old" header files and see/change all the key values. Now how do I transfer these to the new Marlin release headers which have numerous changes of their own?

    The Fläsh1

    Question 1 year ago

    Hello,his tool is working pretty well for me but if try to switch from 1.1.8 to 2.0 i get this error :

    please commit your changes or stash them before you can merge.

    someone any suggestions to get rid off it


    Question 1 year ago on Step 4

    I'm confused. This configurator seems comprehensive and has some nice features but it doesn't appear to store MY configuration info. It seems to me that after I drop in my pre-configured files and make further changes that MY changes would be stored in a data file somewhere other than configuration.h so that when a new Marlin version is released, configurator would be able to pull the new release, apply all of MY unique changes and then be ready for a fresh build. But when I try to change revisions it tells me I need to get rid of my changes. If it can't remember them what is the point of using the tool?, other than for the other nice features. Am I missing something?


    1 year ago

    I installed GIT then the setup.2.7.11.exe, but it won't install, complains about GIT must be installed..But i just did that (with all defaults).

    3 replies

    Reply 1 year ago

    I had the same problem. It seems that that problem goes away if you run GIT GUI, click on Create a new repository and then when you are done, close GIT GUI. Now you can install marlin-conf.


    Reply 1 year ago

    Even after opening GIT GUI and creating a new repository the Marlin Configuration tool still asks for the GIT....... Please could you help? Do I need to reboot the computer?


    Reply 1 year ago

    Took me a while to figure this out and get it working on Windows 10, December 2017

    Here is the tutorial on the wiki for installing it

    You have to install All of the dependencies -

    git, node.js, PlatformIO

    Note you have to install python 2.7 for PlatformIO

    I used the Full Guide to install PlatformIO

    In a command prompt you have to be able to run these commands without errors.





    I then could install marlin-conf-setup-2.8.0.exe

    When I ran the exe it asked for previous Marlin directory or empty, so I created an empty folder and selected it, then it downloaded Marlin.

    Hope this helps someone as it wasn't straight forward.

    Zach Sousa

    1 year ago

    Thanks for this! Very useful for testing each setting because of how simple the layout is.


    1 year ago

    I'm excited about this tool, because I can't get Marlin 1.1.5 to support G29 on my delta printer. Perhaps I have a mistake in configuration, so I want to try out your tool. You say "after selecting folder it will download the firmware (it can take a minute - real size of repository about 50 Mb)", but it isn't downloading. It's been an hour and the target folder is still empty. If I download Marlin 1.1.5 on my own it takes 10 seconds. I can run marlin-conf again and select the folder again, but I always get the same result. No download. I'm using Win10. Do you have any suggestions?

    1 reply

    Reply 1 year ago

    must be installed the GIT but not GIT GUI, after installing You can check working with Menu-R cmd <Enter> git <Enter> - if You get an error then reinstall the GIT with default settings


    1 year ago

    Hi, could you help me out plz, i installed git and then the app, i made a folder and put marlin 1.1.5 into it, i then changed the config file with one from the hypercube EVO, every time i open the app, it wants me to select the map, then it gives a message it wil download or do something, but the program doesnt start up? I cant get to step 3 ...


    1 year ago

    Welcome to Instructables! Thanks for sharing :)