- 1 Introduction
- 2 Prototypes
- 3 Balsa Hardware Requirements
- 4 The Balsa User Environment
- 5 Obtaining A Balsa SD Card Image
- 6 Preparing and Using a Balsa Card
- 7 Support
- 8 Notes for Specific Applications Running Under Balsa
- 9 Re-Initializing Balsa
Balsa is a hardware+software computer solution for use by language workers in remote areas, where infrastructure for computer use is a major problem. More about the goals see Balsa: Basic Language Software Appliance
So far, SIL has produced two prototypes of Balsa.
- Based on Xubuntu Intrepid, created by installing Xubuntu to a real system.
- Based on Xubuntu Jaunty, created using an automated builder process.
- Based on Xubuntu Lucid, also includes better installation including from Windows.
Balsa Beta-1 (Lucid)
A quick set of instructions for setting up a computer with the Balsa are available: A Quick Start for Balsa
The Lucid prototype has the same automated builder as Jaunty, but has significantly changed the distribution and installation, particularly for installation on a Windows machine.
Prototype 2 (Jaunty)
This prototype can also use the tarball distribution mechanism. However, due to the use of an automated builder that is driven by a description called a "buildfile", it is open to customization through editing of the buildfile before running the builder process.
The Jaunty prototype will run on OLPC XO hardware.
Prototype 1 (Intrepid)
This is available by downloading a tarball from the main Balsa site. This tarball is installed onto a newly-formatted SD card. It can be done on the OLPC XO itself by putting the tarball onto a USB flash drive and following the instructions.
The tarball was produced by a manual process which involved installing Xubuntu to a real system, adding users and installing packages, and then saving the result.
This prototype is described on the main site, so isn't described any further here.
Balsa Hardware Requirements
Some notes on the hardware required to run Balsa are available: Balsa Hardware Requirements
The Balsa User Environment
The Balsa user environment uses the launcher-based UI with a tabbed taskbar. There are six tabs:
- Work (screen shot)
- Write & Draw (screen shot)
- Learning & Fun (screen shot)
- Record & Play (screen shot)
- Internet (screen shot)
- Settings (screen shot)
The screen shots are from the Beta-1 (Lucid) prototype.
Obtaining A Balsa SD Card Image
Alternatively, the instructions for Running the Balsa Builder tell you how to build a Balsa SD card image from scratch.
Preparing and Using a Balsa Card
- For a Lucid build see the Quick Start for Balsa
- For an OLPC XO/Jaunty build see Jaunty - Download and Produce a Balsa SD Card using a Windows Machine or Jaunty - Download and Produce a Balsa SD Card using a Linux Machine.
After creating and copying the BalsaRoot SD card, you may insert the card into an unlocked OLPC XO computer. Turn the computer on and it will recognize and boot from the card.
For Jaunty A non-XO system will need some separate preparation. There are separate pages for:
- booting a Linux SD card from Windows XP
- booting a Linux SD card from Windows Vista or 7
- Set up GRUB to boot a Linux SD card (on a Linux computer)
Bugs may be reported using the Balsa Bugzilla database. Please check to see if the same or a similar bug exists in the database before adding a new one.
The pages Overview of Balsa on a Windows Host and Overview of Balsa on a Linux Host give a technical overview of the Balsa installation. More information is available on the page Other Advanced Balsa Configurations.
Contacting the developers
If you have any difficulty following these instructions, or have questions that are not covered here, you can contact the team in these ways:
- Leave comments on the discussion tab associated with this page (requires registration). Please sign your comments using the "add signature" button in the editing toolbar
- Use our IRC channel
- Send a message to
Running the builder creates a sibling directory to balsa-builder named balsa-results. In that directory it creates a file named latest_log. Including this in queries will help us to address any difficulties. When using IRC or the discussion tab, we recommend uploading the file to a service like pastebin.com and pasting the resulting URL.
Undetectable errors are infinite in variety, in contrast to detectable errors, which by definition are limited — Gilb's 3rd Law of Unreliability
Some of the applications included with Balsa have dialog boxes that are too large for netbook screens. If you hold down the <ALT> key while dragging the dialogue box, you can move the portions of the box that are off the screen onto the screen. Use this work-around to get access to buttons that are off the screen.
Consult the Balsa Bugzilla database for an up-to-date list of outstanding bugs.
Notes for Specific Applications Running Under Balsa
- Configure KMFL under Balsa - Jaunty/SCIM version
- KMFL with iBus - Lucid
- Configure Balsa programs and applications
This section is for advisors only. If you need to completely re-initialize Balsa, you can do it this way:
- Backup all your files both for the advisor account and the Balsa user account
- Restart the machine
- At the Balsa login Screen type <Ctrl-ALT>F1. You will have a text screen login with a terminal session.
- Log in as advisor. The password is the same as for the graphical login.
- Type the following commands:
cd / sudo umount /home sudo rm -rf /media/nand/balsafiles sudo reboot
This will remove all the files from the Balsa system. You can restore what you need from the backup you made.