Main Wiki More details on the Uzebox Tutorials to help get started Downloads the project files Help forums
Warning! This tutorial is seriously out-of-date and will not compile on the latest Uzebox software. Check the WIKI for examples and other tutorials.
Software Requirements
The following software is required:
  • AVR Studio: Atmel free IDE for developing with AVR devices.
  • WinAVR: WinAVR is required to program in C with GCC.
  • Eclipse: Required to use the tools coded in Java.
  • The Uzebox kernel files from the download section.
The following software are optional but highly useful in making games:
  • A graphic edition program like Photoshop or The Gimp to make tiles, sprites, etc.
  • A MIDI capable music program like Sonar, Cubase or open source equivalents to compose your game's music.
Getting started

Here's a quick and dirty tutorial on how to display the classic Hello World on the Uzebox.
  1. Start AVR Studio and select Project->New Project. Select AVR GCC as new project type and name your project HelloWorld.
  2. In the next dialog select the simulator as your debug platform and select the ATmega644 as the device. Click finish.
  3. Select Project->Configuration Options and uncheck box the named "Unsigned chars". Set the optimization to -Os. Click Ok.
  4. Unzip the Uzebox files where you created the project.
  5. Add the kernel files to the project: Right "Source Files" in the left pane and select "Add existing source files...". Now add all the files in the kernel sub-folder.
  6. Edit the HelloWorld.c file and add the following code to it
    #include <avr/io.h>
    #include <stdlib.h>
    #include <avr/pgmspace.h>
    #include "kernel/video.h"
    #include "data/"

    const char strHello[] PROGMEM ="HELLO WORLD FROM THE UZEBOX!";

    int main(){



  7. Press F7 to build the project.
  8. From the toolbar, click the button named "Connect to the select AVR Programmer". The following pop-up comes up. Select the location of the .hex file (usually under [your project dir]/default).
  9. Click "Program"!
  10. Enjoy!

Copyright (c) 2008 Uze, Belogic
The Uzebox (including source code and hardware design) is released under the GNU GPL 3.0 Public Licence.
Pictures and content of this site is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License.