EverDrive GBA Pro Theme Builder
File Browser
Main Menu

Color mapping

Slot roles per palette
slot0 - BGR Background & transparency fill colour slot1 - BARS Bar backgrounds, header/footer fills & highlights slot2 - TEXT0 Primary text colour slot3 - TEXT1 Secondary / accent text colour
Per-palette roles -- main menu
pal0[1] -- Menu background (BARS)
pal0[2] -- Box border, title text & unselected item text
pal2[1] -- Selected item highlight bar
pal2[2] -- Selected item text

Notes from gbatheme manual

Palettes

There are 16 physical palettes. Using the *_pal directive you can reference palette numbers 0 to 31.

Palettes 0-15 fill transparent font pixels with color 0 of the palette.
Palettes 16-31 are identical but fill transparent pixels with color 1 instead.

Palette 15 is reserved for the background -- only set its colors if you want to define background image colors manually.

Colors & format

Each palette holds 16 colors stored as hex values with 5 bits per channel (BGR555 format). The very first color in each palette is the transparency color.

Background images should use no more than 15 colors so the system can reserve one slot for transparency. Exceeding this may cause graphical artifacts.

Using the tool

Write your directives into a cfg.txt file, then either:

  • Drag cfg.txt onto gbatheme.exe
  • Or run the included make theme.bat file

Both methods compile your config into a .bgr file ready to copy onto your EverDrive SD card.

Header Bar
Footer Bar
File Manager
Menu Palettes
Scroll