Kuku/For Testers

From OLPC
Jump to navigation Jump to search

Below you will find instructions on how to download and run the latest version of Kuku Anakula. See the section appropriate for the platform you are using. Please add your feedback on what you liked and disliked. Your suggestions will be read carefully and will be used to improve Kuku.

Testers on A Computer With Pygame Installed

We are assuming you can/have:

  • python and pygame installed
  • unzip a file
  • locate a directory with a shell
  • execute python

Steps to download and play Kuku:

  1. Download the latest code by clicking on http://dev.laptop.org/~lucks/kuku.zip
  2. Locate and unzip kuku.zip (most likely on your Desktop)
    • You should now see a folder (directory) called Kuku.activity
  3. Enter the folder or directory
    • Now you need to execute the file kuku.py. Sometimes you can just double-click on the file to run it, and the game should start. If you know how to use the shell, you can also execute the file by opening a shell and cd'ing into the directory, and then typing
      python kuku.py
  4. You should now be playing Kuku Anakula.
  5. Give us feedback!

Changing the Game Levels

You can change the types of questions that Kuku uses. You should can see a list of the files that kuku uses by looking in the folder

Kuku.activity/data/question_files/arithmetic/

There is a special file called

Kuku.activity/data/question_files/arithmetic/my_questions.dat

Open that file in a text editor, and you should see lines of question like

3 + 4 = 7
41 + 94 = 135
-5 + -10 = -15
-765 - -269 = -496
4 + 9 = 13
92 - 78 = 14
40 / 10 = 4
7802 / 83 = 94
#make sure you leave this line!

Anything to the left side of the = sign is the question, and the answer is to the right. Feel free to edit this file - the only thing you have to make sure is

  • your answers is an integer
  • your answers are correct!
  • you leave the line that says "#make sure you leave this line!"

Be sure to save the file. You are now one step away from making Kuku ask the questions you want. Open up the file

Kuku.activity/kuku_config.py

At the very bottom, you will find a line that looks like

#QUESTION_FILES = ["question_files/arithmetic/my_questions.dat"]

Change this to (i.e. remove the # sign)

QUESTION_FILES = ["question_files/arithmetic/my_questions.dat"]

then save the file and restart the game. You should now be playing Kuku with your questions. You can add as many questions as you want!

Testers Using an XO or qemu emulator

You first need to make an Activities directory. As the olpc user do

cd ~olpc
mkdir Activities
cd Activities

Now download the latest kuku.xo file

wget http://dev.laptop.org/~lucks/kuku.xo
unzip kuku.xo

Then restart X

killall X

You should see the Kuku chicken icon in the activity bar at the bottom of the home screen.