From WikiTemp, the GBAtemp wiki

Creating Custom Icons

External icons are supported in AKAIO. They must be in BMP format at 32x32x15bpp. Naming conventions are described below. Mr.VatoLoco has compiled icons for the use with the AKAIO, you can find his post here

AKAIO has a custom icon system whereby specially formatted bitmaps (*.bmp) can be placed on your microSD and used as a replacement for the usual icons, both those built into Nintendo DS games and those used by AKAIO itself, for example the generic "Game Boy Advance" icon which is displayed for all *.gba files. However, due to the limitations on the DS hardware, the most common formats of *.bmp file (e.g. the types generated by MS Paint) are not able to be used for this purpose, and they must instead be saved with some required specifications. There are several methods of generating this type of bitmap, detailed below.

Per Extension Icons

Icons named with the extension of the file you wish to associate them with can be placed in the __aio/icons directory for global usage, or your skin's /icons directory for usage with just that skin (__aio/ui/Adv.Evo/icons). For example, to use a custom icon for all files with a "TXT" extension, your icon will be named "TXT.BMP."

Per File Icons

Specific icons can be assigned to specific files in AKAIO. Make a standard 32x32x15bpp BMP icon for the file and name it the exact name of the file, but with a .BMP extension. For example, for the file "Bob's homebrew Game.nds", you would use a BMP properly formatted BMP file named "Bob's homebrew Game.BMP."

Make sure to place these icons in the same directory as the file you are assigning them to.

Using Gimp

The image resolution required for custom icons is 32*32 pixels. If you already have a 32*32 image that you've made previously or downloaded from the Internet, all you need to do is save it in the correct format by opening it in GIMP, clicking the "File" dropdown at the top of the image window and then clicking "Save As...". See below for the specifics on how to save your icons.

If you're creating a new image, then the "Create a New Image" window will allow you to select the correct resolution of your icon. Simply enter "32" into both the "Height" and "Width" boxes on that screen, and hit "OK" to begin working on your custom icon.

If you're editing an image which is currently larger than 32*32, it is possible to change the in-progress image's attributes by clicking the "Image" dropdown and moving down to "Canvas Size". In the "Canvas Size" window, you may enter your width and height, similarly to the way this is done when creating a new image. Note that you may need to click on the chain icon next to these boxes; the chain represents a forced aspect ratio: editing one digit will automatically edit the other in order to make the image stay the same shape when it resizes (i.e. a "landscape" image would remain "landscape", just resized to your chosen dimensions). This is usually great, but not at all helpful when you need to make perfect square images, so unless your source image is already a perfect square, the chain should be unlinked. Be aware, however, that changing the canvas size will not resize the image; it it's not the same thing as scaling the image, which isn't covered here.

Once you're ready to save your image, hit "File", "Save As..." and type your filename into the box. You can either choose your file format by expanding the section at the bottom of the window, or simply by typing it into the filename field (e.g. akaiotest.bmp would save the file as a bmp). Now a "Save as BMP" window should appear, with a collapsed "Advanced Options" section. Expand it and select the "X1 R5 G5 B5" option under the "16 bits" header. Hit "Save" and your custom icon is done.

If you want to use this icon for a specific file (e.g. because you don't like the built-in icon or because you want to give icons to GBA games, etc.), rename the *.bmp to exactly match the file name of the target, minus the extension (so a custom icon for ClIRC.nds would be named ClIRC.bmp). Place your *.bmp in the same folder as the corresponding file, and when you next boot AKAIO, it should appear in place of the default icon. If you want to use this icon for a specific file format (e.g. as an icon for text files), place them in the folder /__aio/icons/ with the file format of your choice for a name (e.g. *.txt files, the bitmap should be named txt.bmp).


GIMP is an open-source image editor available for most major OSes, including Windows, Mac OS X and Unix/Linux. It is often compared to Adobe's Photoshop image editor, however GIMP is freely available for download. It can save images in a wide variety of formats, but importantly in this case, it is able to generate the specific type of bitmap used by AKAIO.

Icon Packs

External Links