Installing Games

The process for installing games on your Arduboy is dependant on the variant you have. Older Arduboys can only support a single game whereas new FX and Mini variants are equipped with a flash chip that allows it to store many games at once and these are made accessible by a menu when the unit is first turned on.

Distribution Methods

Arduboy games can be distributed multiple ways and the method affects how it can be installed onto a physical unit.

Distribution methods include:

• as source code. Prior to installing the game, you will need to compile it within an Arduboy development environment - such as the Arduino IDE or VS Code - and then upload it to the unit. Refer to sections #Installing a Single Game using the Arduino IDE and
• as a single .hex file.
• as a single .hex file and accompanied by one or more .bin files.
• as an `.arduboy` file. The `.arduboy` format is an archive file that contains the program's main .hex file, any supporting .bin files and graphics in a single package for convenience.

asdasdasdas das d asd a da sd asd as das d asd asd a sda sd asd as asd as da d asd as asd as da sd asd as da sd asd a da da sd as da sd ad a sda sd asd as da sd a dsa sda sd asd a da sd asd a sd asd a da dasda s

Installing a Single Game

Applies to all Arduboy variants.

There are many different ways to install a single game onto the Arduboy.

Installing a Single Game using the Arduino IDE

The Arduino IDE allows Arduboy programs to be compiled and uploaded to the unit automatically. Compiling a game produces a .hex file and (optionally) one or more .bin files.

Installing a Single Game using the VS Code IDE

The VS Code allows Arduboy programs to be compiled and uploaded to the unit automatically.

Installing a Single Game using the Arduboy Toolset

The Arduboy Toolset provides a convenient, GUI based tool for uploading `.hex` files and (optionally) a single `'bin` file.

Updating an Arduboy's Cart

Applies to the Arduboy FX, Arduboy Mini and homegrown variants that have an FX extension.