Sugar Instructions

Installing

If you have an OLPC laptop, Sugar is already installed. Otherwise you can either use an emulated laptop, which will have Sugar built in, or you can install Python on your desktop PC and run the Sugar application directly on your PC. If you are running Sugar from Python then you can skip most of the stuff in the next section, up to choosing your user name.

First Booting

Whenever you boot an emulated laptop, press SPACE to choose emulated.

The OLPC or emulated laptop will go through the booting steps, saying OK after each one. Don't press or type anything.

Then it will go to a login prompt. You don't have to type anything. Just wait and it will start the GUI. If you don't want to wait for the GUI to load, you can log in with username "root" and no password.

If you wait, the GUI will start. If the GUI fails to start, you may have forgotten to choose emulated when you booted, or you may have encountered the "GUI won't start" bug. The "GUI won't start" bug is fixed by reinstalling the hard disk image. In QEMU, delete the .img file (it has become corrupted), and extract the original .img file from the bz2 file, or download the image file again. Upgrading to a later version isn't necessary.

Choosing a User-name

The first time Sugar starts it will pop up with a box asking for a username. Type in any name you want the computer to call you. Don't leave it blank. Press OK or Enter. It will automatically choose a colour for you.

Getting Started with the Sugar Desktop

The Sugar desktop starts up in Home mode.

This shows a picture of you in the centre of the screen.

Later on we will see many people, but at the moment we can only see you.

Each person is a different colour.

Opening an Activity

Sugar uses "activities" rather than "applications".

For example a web browser is a type of activity in Sugar.

The circle around you shows which activities are running.

At the moment there are no activities running, so the circle is empty.

So let's open an activity.

To open an activity, move your mouse to the edge of the screen.

The "Frame" will appear.

At the bottom of the frame there are some icons.

These are the activities that you can open.

For example, AbiWord (a word processsor) is shaped like a triangle.

To open an activity, click on it. AbiWord will open as shown below.

You can open several activities at the same time, by going to the bottom of the frame, and clicking on another icon.

Switching Between Activities

To see which activities are open, go to the frame, and in the top left corner, you will see four "Zoom Icons".

Then click on the "Home" view.

If you have a genuine OLPC laptop, you can change zoom mode by pressing the appropriate button on the top of your keyboard, shown below.

Now you will see your icon in the centre, and the AbiWord icon in the surrounding circle.

If you have more than one activity running, you can switch to it by clicking on the appropriate icon in the circle.

Closing or Sharing Activities

To close an activity, select it (for example AbiWord). The activity will open.

Then go to the top of the frame. You will see the AbiWord icon at the top of the frame.

Move your mouse on the icon but don't click.

A box will appear with two more icons.

Click on the "X" icon to close the activity.

To share an activity with other people, go to the frame at the top, and move your mouse on to the activity icon.

A box will drop down, then click on the circle with many dots inside.

You are now sharing your activity. To find out more about sharing activities with others, read about Neighbourhood View Mode.

Shutting Down the System

To shut down the whole system, go to the top of the frame, and move the mouse over the "X" icon on the right.

Then a box will drop down saying "Shut Down".

Click on the words "Shut Down" and wait a few seconds for the system to shut down.

The Sugar desktop starts up in "Home" mode. This shows a picture of you, surrounded by the activities you are currently using.

If you aren't running any activities, then there isn't much here. You can't actually do much on this screen.

There are three different levels of "zoom", so you can see not just yourself and your activities, but also your friends, or everyone on the local network. If you have a real laptop keyboard, you can use these keys on the top row of the keyboard to change the zoom level:

The first one with lots of dots shows everyone in the "neighbourhood", and what activities they are sharing. The second one with three dots shows just your friends and their activities. The third one with a single dot represents the "home" mode it started in, with just you and your activities. The fourth one with the rectangle, toggles an extra transparent layer on top of the view, where you can add comments and stick items, like an old-fashioned buletin board, that you want to share with everyone in that view.

Neigbourhood View Mode

Neighbourhood mode shows you other people connected on the network. It also shows you which activities they are running, and which activities are being shared. Each person is represented by a different colour.

The activities are colour coded with the colours of whoever started the activity. In this case the painting activity was started by the orange and purple girl, who you can see surrounding the orange and purple activity in the neighbourhood view in the middle of that screen.

The left frame is the clipboard. You can copy multiple items to the clipboard.

The right frame is your buddy list. It shows your friends that are online.

The bottom frame is like the windows start menu that you use for launching applications. The icons represent different activities that you can start. In the above screen shot, the activities are from left-to-right: painting, word processor, chat, and web browser. You will also have other activities on your laptop. A shooting star icon will represent Squeak e-toys, which is a fun visual programming and drawing application.

When you receive an invitation from your friend to join an activity, it will appear in the bottom frame in colour. A pop-up menu lets you accept or reject the invitation. Notifications may also appear in the bottom frame.

The top of the frame has the icons for "neigbourhood", "friends", "home", and "bulletin board", just like on the keyboard. It also has something like the Windows "task bar" with the icons for the currently running activities.

Shortcut Keys

You can use the following shortcut keys in Sugar:

• F1 = Zoom out to Neighbourhood view
• F2 = Zoom to Friends view
• F3 = Zoom in to Home view

• Ctrl+Alt+F1 (hold down) = leave Sugar screen, and return to linux prompt, so you can log in as "root" with no password.
• Ctrl+Alt+F7 (hold down) = return to Sugar Screen
• Ctrl+Alt+Backspace = terminate Sugar immediately without closing down properly. It will restart automatically in the background (use Ctrl+Alt+F7 to see it restarted).

• Alt+Shift+F9 = toggle frame

• Alt+Shift+F11 = start terminal (linux prompt) as user "olpc", you won't be able to log in as "root".

• Alt+Shift+F12 = show sugar-log-viewer window

Terminal (linux prompt)

You can access the linux prompt in two ways... Either hold down Ctrl+Alt+F1 to leave the Sugar screen and return to the login prompt, or press Alt+Shift+F11 to open the terminal activity within Sugar.

If you use Ctrl+Alt+F1 to leave Sugar, you can return to Sugar with Ctrl+Alt+F7.

If you use Alt+Shift+F11 you won't be logged in as "root" but as "olpc". You need to be logged in as "root" to edit some of the setup files, such as "/boot/grub/grub.conf". You can gain root access by typing "su -". The prompt suffix will change to # which denotes that you are root. You will not be able to start any graphical programs as root using this method.

For example, if you want to edit "/boot/grub/grub.conf" with AbiWord in Sugar, hold down Ctrl+Alt+F1 to leave Sugar, and type "root" for the log in. Type "chmod a+rw /boot/grub/grub.conf". Then return to Sugar by holding down Ctrl+Alt+F7. Now you can open and save that file in AbiWord.

Some basic linux commads you can use at the prompt are:

• ls -al (get a list of the files)
• cd dirname (change to directory dirname)
• cat filename (show the contents of filename)

Web browser

The Sugar web-browser is started by the clicking the wireframe globe icon in the bottom frame. It is based on Mozilla Firefox.

The web browser has a simple interface. By default it has one toolbar across the top, with back, forward, and reload buttons, followed by a box with the page title or URL, and a "+" button which adds an extra browser tab. If you click the "+" button then it adds a new tab, and a new toolbar appears on the left side of the screen which displays all the tabs. I couldn't work out how to close tabs.

When you click on the title box, it will change to showing the URL, and you can type in a new address and press Enter to make it go there. The title box also shows the loading progress as a bar in the background.

Don't confuse the tool bars with the similar looking frame. You can still move the cursor to the corner of the screen to pop in the frame over the top. You can then click on the coloured wire-frame globe icon in the top frame and choose close from the drop down menu.

NOTE: Currently, when a link opens in a new window, you will be stuck in that window until you close it from the top frame, at which point you will see the previous window until you close all the browser windows.