Qt Creator setup guide

Qt Creator is a cross-platform integrated development environment (IDE) built for the maximum developer experience. Qt Creator runs on Windows, Linux, and macOS desktop operating systems, and allows developers to create applications across desktop, mobile, and embedded platforms.

Since it has lots of C++ advanced features for a free IDE, it is a good fit for Butano projects.

This is a small tutorial for setting up Butano template project in Qt Creator 4.14. Although the guide has been made in Windows, the steps for other operating systems are similar if not the same.

Getting started

Before messing with Qt Creator, make sure that you are able to build and run Butano projects from the system console. The best way to achieve it is to read the guide to download, install and start using Butano.

Install Qt Creator

If you don't have Qt Creator installed yet, you can get it from here.



Once you have Qt Creator installed, add devkitARM GCC and G++ compilers from Tools -> Options -> Kits -> Compilers:



Add a new kit with the previous devkitARM compilers from Tools -> Options -> Kits -> Kits:


You can ignore the yellow triangle: it is a warning, not an error.

Import template project

Now that you have the kit setup, import Butano template project from File -> New File or Project...:



Enable C++20 support in the template.cxxflags file with the following line:


Include paths

Add the following paths to the template.includes file:


Build settings

Disable all build target from Projects -> Build Settings -> Build Steps:


Run settings

Add your favorite GBA emulator from Projects -> Run Settings -> Run:


Build and run

Finally, build and run the template project by clicking at the bottom left arrow (the one without the roach please).

If everything went as expected, your GBA emulator of choice should show a nice black screen. Congrats!