/libtonc-template

GBA example C project using libtonc

Primary LanguageMakefile

Quickstart

"I want to make GBA homebrew, where do I begin?"

  1. Install devkitARM for your system.

  2. Read Tonc to learn all about GBA programming!

    • You can skip "Setting up a development environment" because we did that in step 1.

  3. Clone this repo and run make in your terminal.

    • If you used the graphical installer on Windows for step 1, you should use the MSYS2 terminal for this step.

About this repo

This is a minimal GBA example project using libtonc instead of libgba.

The commit history exists to document the process of converting a libgba example to a libtonc example.

Why?

devkitPro provides two general-purpose libraries: libgba and libtonc. Of the two, I recommend libtonc, because it has better documentation and more features (it's part of the accompanying material to the excellent Tonc tutorial).

The trouble here is that all the GBA examples are using libgba, and converting the libgba template to use libtonc is non-trivial for those who are just getting started.