Create a New MPLAB® Harmony Project


Install the MPLAB® Harmony Configurator (MHC)

Before you create a new "MPLAB® Harmony Project", you must install the MPLAB Harmony Configurator (MHC) graphical user interface. This GUI enables you to easily add and configure the Harmony library files needed for your application. It also enables the MPLAB X IDE to create a new "MPLAB Harmony Project".

Instructions for installing the MHC plugin >


Create a New MPLAB® Harmony Project

  1. In the MPLAB® X IDE, select File ▶ New Project
    (or click Main_New_Project.png in the toolbar).
  2. Select the Microchip Embedded category if it is not already selected.
  3. From the Projects list, select MPLAB Harmony Project.
  4. Click Next >.

If you do not see the "MPLAB Harmony Project" option you have not installed the MHC. Click here for instructions.


The next window should have the default Harmony Path, Project Location and Project Path already selected for you. Remember the MPLAB® Harmony framework expects to find specific files in specific locations. Do not change these default paths because the project may not build.

  1. Set the Harmony installation path
  2. Set the project location
  3. Enter the project name you would like to use
  4. (Optional) Change the project configuration name or just use "default"
  5. Select the target device from the drop-down window (Which PIC32 is on my board?)
  6. Click Finish

After you click Finish, your new project will be opened.

MPLAB® Harmony Project Wizard Details
Learn more >

To view the following video full screen, click on the video title (view on YouTube).

The MPLAB® Harmony Configurator (MHC) plug-in must first be installed into the MPLAB® X IDE before creating an MPLAB Harmony Project. Click here for instructions on how to do this.

This video will show you how to create an MPLAB® Harmony Project in the MPLAB X IDE. For details on how an MPLAB Harmony Project differs from a typical "Standalone Project", click here.

© 2019 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.