Tutorial: Installing KookaSuite on a Mac

A learning plan for the Kookaberry

Developed by
John Phillips
Director
The AustSTEM Foundation

This Tutorial describes how to download the KookaSuite folder to a Windows PC

Contents

Overview

Installing KookaSuite Software on your Mac

Step1: Access Files in GitHub

Step2: Finding the right file

Step3: Loading the files

Step4: Warning Notices

Step5: Allowing File download

Step 5: Opening files

Installing KookaScripts

Step1: Installing KookaScripts

Step 2: Downloading KookaScripts Folder

Step 3: Selecting the destination folder

Step 4: Checking the files and location

Step 5: Using the Scripts

Overview

This Tutorial describes how to download the KookaSuite folder to a Mac and how to safely install and access the following files

  • KookaBlockly – an implementation of the GoogleBlockly programming environment for the Kookaberry
  • KookaIDE – an Integrated Development Environment for programming the Kookaberry in MicroPython; and
  • KookaTW – the Kookaberry Teacher’s Window that mirrors the Kookaberry’s display

Unlike many other web based popular code editors such as Mu Editor and Microsoft’s MakeCode; KookaSuite is loaded onto a local computer and does not require an internet connection to operate.

The instructions below assume that Safari is being used as your web browser

Installing KookaSuite Software on your Mac

IMPORTANT: The KookaSuite files are “executable” files and such files, unless they have been certified as not posing a threat to a computer’s operating system, will generate warning signs and discard instructions before they will finally be allowed to load or run.

THESE Kookaberry FILES in GitHub ARE SAFE TO LOAD AND RUN. AustSTEM will commence the certification process after the next firmware version is fully tested.

Step1: Access Files in GitHub

The software for the KookaSuite is contained in downloadable GitHub files.

Take me to GitHub →

Clicking on the above link will take you to the correct location on the GitHub website where you will see the window in the screenshot. Note: Although the KookaSuite description only references macOS, the folder also contains file for Windows.

Step2: Finding the right file

Click on the KookaSuite folder and the window in the top screenshot will appear.

Now click on the KookaSuite-1_6-macOS.zip file and the window shown in the bottom screenshot will appear

Click Download

Step3: Loading the files

The unzipped Kookaberry-1.6 folder will appear in the Downloads folder on your Mac. If only the zip file appears in the Downloads folder, double click on the zip file and the Macintosh should extract the “Kookaberry-1.6” folder (where 1.5 is the version number at the time of writing and may change with future releases).

Click and drag the Kookaberry folder into your Home folder

Double click on the Kookaberry-1.6 folder to open it and view the three executable files

Step4: Warning Notices

Running any of these applications at this stage of the download process will result in the warning notice shown in the screenshot.

You will need to go to the Security and Privacy Settings on your Mac to open these files

The next Steps will lead you through this process

Step5: Allowing File download

Go to the Security and Privacy section in your Settings and the window in the screenshot will appear.

Toward the bottom of the window the attempt to open the program is noted and a button “Open Anyway” is given.  Click on that.

By this means you are giving permission for this program to run henceforth.

The warning dialogue will reappear – this time with an Open button.

Click on this button to open the application

Repeat for each of the applications in KookaSuite

Step 5: Opening files

After the above validation process is complete the applications should run without further security warnings, but you may occasionally be asked to confirm the opening of a KookaSuite file when you want to want to use it.

Installing KookaScripts

Step1: Installing KookaScripts

In computing, the word script is used to refer to a file containing a logical sequence of computer commands or a batch processing file. This is usually a simple program, stored in a plain text file.

In MicroPython they are an abbreviation of the name of the programme followed by “.py”. eg “Welcome.py”

In the screenshots of the KookaBlockly and KookaIDE windows, you will see a menu box saying “Scripts”, and an adjacent box saying “Choose a script”.

These menus allow you to select pre-loaded scripts rather than load them individually using the Load command.

On first installation these menus will not show anything – a folder named “KookaberryScripts” needs to be installed as well. This has to be downloaded onto your computer as a “one-off” operation at the same time as you install KookaSuite.

   

Step 2: Downloading KookaScripts Folder

Download the KookaberryScripts.zip file from the sidebar to the right and save it to your Home folder. The KookaberryScripts folder has to  be in the same folder as the KookaSuite folder.

 

 

Version:[to add to metabox]


Last updated: 8 months ago


Resource type:[to add to metabox]


Year levels: Year 5, Year 6, Year 7, Year 8, Year 9, Year 10, Year 11, Year 12, Tertiary Level


Downloads



Download on GitHub
View support forum
Image

Leave a Reply