This Tutorial describes how to download the KookaSuite folder to a Windows PC
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.
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.
Click on the KookaSuite folder and the window in the top screenshot will appear.
Now click on the KookaSuite-1_5-macOS.zip file and the window shown in the bottom screenshot will appear
The unzipped Kookaberry-1.5 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.5” 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 the Applications folder
Click on the Kookaberry-1.5 folder to open it and view the three executable files
These files can also be accessed from the Shortcuts icon in the Dock
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
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
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.
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.
Download the zip file from this Kookaberry website location to the Downloads folder and then to a specific destination on your PC as detailed in Step 3 below
Copy the KookaberryScripts folder to the user’s home folder on the Macintosh (the one with your name on it).
When the KookaScripts folder is in the above location its files look like the screenshot to the right.
The top screenshot shows the files in the KookaBlockly Demo folder and the bottom the equivalent in the KookaIDE
This is what you should see in the KookaBlockly and KookaIDE windows when KookaScripts is successfully downloaded