Compile Marlin Firmware without VSCode - Let's Print 3D (2023)

Marlin firmware has long been the industry standard for 3D Printers. It’s reliable, open source and actively maintained, with a massive community of contributors behind it. In order to compile Marlin firmware though, we need to familiarize ourselves with a programming environment.

Most tutorials use VSCode and a PlatformIO plugin, and there’s nothing wrong with that approach, but ambiguous errors are almost guaranteed within Microsoft’s Visual Studio. In this guide, we’ll compile Marlin firmware from the command line, bypassing the extra software and keeping this as simple as possible.


Before we can compile Marlin firmware, we must first install two software packages, Python and PlatformIO.

1. Python

Python is a high level, general purpose programming language. It comes pre-installed on most operating systems with the exception of Windows.

Our firmware compiler, PlatformIO, is built on top of Python. As such, we’ll download and install the latest version before moving forward.

Launching the Python Windows Installer will bring us to the following screen. Make sure “Add Python 3.9 to PATH” is checked at the bottom, then click Install Now to start the setup.

Compile Marlin Firmware without VSCode - Let's Print 3D (1)

2. PlatformIO

PlatformIO is a cross-platform, cross-architecture, multi-framework IDE for developing embedded systems. Simply put, you can compile the same code for different devices without much hassle.

(Video) Updated Marlin firmware setup guide - VS Code and Auto Build Marlin

Start by creating a new folder on your Windows PC, we’ll call this “platformio”. Download the PlatformIO installer script from the following link, then place this file inside of our new directory.

From the “platformio” folder, click the file bar at the top and type in “cmd”. Press enter and this will open a command prompt in the current directory.

Compile Marlin Firmware without VSCode - Let's Print 3D (2)

At the command prompt, run the PlatformIO installer script we downloaded by typing “python” and press enter. This will take around 30 seconds to complete.

Compile Marlin Firmware without VSCode - Let's Print 3D (3)

With PlatformIO now installed, the last step is to add it to our environmental PATH variable. This allows Windows to recognize the application by name, know where the files are located and run it from anywhere.

  • Open Control Panel by pressing Windows Key + R, then type “control”
  • Go to System -> Advanced System Settings
  • Under the Advanced tab, click the Environmental Variables button
  • Double click the “Path” variable under System Variables

Add a new entry to the list for PlatformIO and specify the path where it was installed. This should be “C:\Users\username\.platformio\penv\Scripts”, replacing “username” with your Window’s account name. Press OK to save the changes.

Compile Marlin Firmware without VSCode - Let's Print 3D (4)

Download Marlin Firmware

(Video) MARLIN - Essential Guide To Start Editing Your Own FIRMWARE

With our prerequisites done, we’ll grab the latest release of Marlin firmware. Either clone the source code from their official Github page, or download the compressed ZIP archive below.

Extracting this archive will create a “Marlin-2.0.x” folder, containing the files we need to compile our firmware.

Keep in mind, the default configurations are just a generic example, it’s not setup to work with any particular 3D Printer. To ensure the firmware runs as expected, we’ll update the configuration files to match our machine in the next step.

Configure Marlin Firmware

Marlin has a massive library of ready made configuration files, supporting hundreds of different 3D Printers. Based on the machine’s original firmware, these are templates that can be used as-is or customized to your preference.

When manufacturers violate the GPL license and don’t publish their modified source code (looking at you Creality), this can be a godsend.

Marlin Configuration Files

(Video) Beginner guide to editing Marlin firmware - step by step - UPDATE IN DESCRIPTION

Download and extract this archive. In the ‘config/examples’ directory, we’ll find a list of folders belonging to different manufacturers. There is a collection of sub-folders inside of them, one for each 3D Printer that company has released. In some cases, there is even a third tier of folders for various control boards.

Locate the folder for your 3D Printer and copy all of the files from inside of it. The primary two are Configuration.h and Configuration_adv.h, but most will have a _Bootscreen.h and _Statusscreen.h file as well.

In my case, I have a Creality Ender 3 with a BIGTREETECH SKR Mini E3 2.0 board installed.

Compile Marlin Firmware without VSCode - Let's Print 3D (5)

Take the files that we’ve copied and place them in the ‘Marlin-2.0.x/Marlin’ folder from the previous step. If files with the same name exist in that directory, overwrite them with the new configurations.

Should you wish to make changes before compiling the firmware, now is the chance to do so. Configuration.h file holds the common settings, and despite the file extension, it can be modified with a standard text editor.

Compile Marlin Firmware

Before we can compile Marlin firmware, we need to know what control board is in our 3D Printer. The firmware itself is hardware agnostic, but when compiling it into a binary file, we’re building it for a specific microcontroller.

The full list of boards can be found in our Marlin firmware folder. Navigate to ‘Marlin-2.0.x/src/core/boards.h’ and open it in a text editor. The board names are defined here, one per line, with a comment indicating what 3D Printers use it. Some of the most common options are provided below.

melziStandard 8 bit Creality board
STM32F103RET6_crealityCreality 4.2.2 and 4.2.7 32 bit silent board used on the Ender 3 V2
STM32F103RC_btt_mapleBIGTREETECH SKR Mini E3 V2 board
TH3D_EZBoard_V2TH3D 32 bit board for Creality and Sovol 3D Printers

Once we know the board type, we’re set. Move back to the root directory of our ‘Marlin-2.0.x’ folder and open a new command prompt using ‘cmd’. Execute the following command, replacing board_name with the one found in the previous step.

platformio run -e board_name

In my case, I am using a BIGTREETEECH board, where mine is identified as ‘STM32F103RC_btt_maple’.

Compile Marlin Firmware without VSCode - Let's Print 3D (6)
(Video) VSCODE - Edit Marlin Firmware - How To - Chris's Basement

If everything works as expected, this process will take about 5 minutes to complete. When finished, we should have a confirmation message informing us that the build was a success.

Compile Marlin Firmware without VSCode - Let's Print 3D (7)

Above the success message, we can see the compiled firmware has been placed inside of the directory ‘Marlin-2.0.x\.pio\build\board_name’. Depending on the board type, this will either be called “firmware.hex” or “firmware.bin”.

Flashing Firmware

Flashing custom firmware on modern boards couldn’t be more simple. If you’ve purchased a board from the BIGTREETECH SKR series, or the latest Creality 4.2.7 for example, follow these 3 steps and you’re done.

  • Copy the ‘firmware.bin’ file to an SD card.
  • Insert the card into the 3D Printer and power it on.
  • Wait 30 seconds until the blue screen loads into the standard interface.

When exactly did this become so easy you might ask?

After years of overlooking such an important feature, manufacturers like BTT and Creality have finally started including a bootloader on their 32 bit boards. This is a small program stored in memory which makes it possible to write new firmware.

Better yet, they adopted the Smoothieware bootloader design, capable of loading firmware files right from the SD card. No longer is it necessary to connect the 3D Printer to a PC over USB cable.

Flashing a Bootloader on 8-Bit Boards

Unfortunately most budget printers, the Creality Ender 3 for example, do not come with a bootloader installed. These use a cheap 8-bit Melzi board with the bare minimum functionality. Short of spending $40 for an upgrade, the only way to write custom firmware is to first flash a bootloader.

The good news is, there are several ways to do it, none of which are too difficult. You will however need some specialized tools for the job, and unless these happen to be lying around, that money could be put towards a new 32 bit silent board.

Guide: How to Flash a Bootloader on Melzi Boards

In the guide, we make an ISP (in-system programmer) from an Arduino Uno and some breadboard wires. Both are fairly inexpensive items and common for hobbyists, where this may be an attractive option to some.

(Video) Compiling Marlin 2 0 with VsCode and PlatformIO

Alternatively, we can just purchase an AVR Programmer for less than $10 that is ready to use.

USB AVR Programmer - $9.99

Regardless of what method you choose, they should more or less work exactly the same. It’s also worth mentioning, this is a one time task. Once a bootloader has been flashed to the board, it’s permanent, allowing you to write new firmware as many times as needed.


1. Marlin Input Shaping - Step by step guide to more speed and less ringing
(Teaching Tech)
2. How to build Marlin Firmware Using VSCode easy way (2022)!
(Jimmy's DIY)
3. Easily upgrade the Marlin firmware on your kit 3D printer!
(Thomas Sanladerer)
4. A10T Marlin Firmware Update Bug Fix 2.1 Visual Studio Code 2022
(HL ModTech)
5. How To Update 3D Printer To Marlin 2.1 Firmware (for Ender 3 and more)
6. A Detailed (and Boring) Guide to Setting Up Marlin Firmware Using VSCode
(Minimal 3DP)
Top Articles
Latest Posts
Article information

Author: Tish Haag

Last Updated: 03/07/2023

Views: 5383

Rating: 4.7 / 5 (67 voted)

Reviews: 90% of readers found this page helpful

Author information

Name: Tish Haag

Birthday: 1999-11-18

Address: 30256 Tara Expressway, Kutchburgh, VT 92892-0078

Phone: +4215847628708

Job: Internal Consulting Engineer

Hobby: Roller skating, Roller skating, Kayaking, Flying, Graffiti, Ghost hunting, scrapbook

Introduction: My name is Tish Haag, I am a excited, delightful, curious, beautiful, agreeable, enchanting, fancy person who loves writing and wants to share my knowledge and understanding with you.