Kojo is open source software, and is freely available. You can download and install Kojo 2.x based on the instructions provided on this page. Alternatively, you can Run Kojo Online.

If you are looking for the earlier version of Kojo, you can visit the Kojo 1.0 download page.

New Kojo Releases are announced on the Kojo Blog; you can subscribe to the blog feed to be notified.

Windows

  • Download and install Java 7 (preferred) or Java 6 if you need to. See the Prerequisites section for more details.
  • If you are upgrading from an earlier version of Kojo, make sure that Kojo is not currently running.
  • Download the Kojo Installer (Version: 2.1, 090414-2) and run it to Install Kojo.
  • Optionally download the Media files.
  • After Kojo is installed, you can run it from the Windows Start Menu, via the Kojo v2 Program Group. You can also run it from the Desktop (if you installed Desktop shortcuts).
Windows release notes

Unix/Mac

  • Download and install Java 7 (preferred) or Java 6 if you need to. See the Prerequisites section for more details.
  • If you are upgrading from an earlier version of Kojo, make sure that Kojo is not currently running.
  • Download the Kojo Installer jar file (Version: 2.1, 090414-2) and save it at a known location on your computer (the name of the jar file has the form: kojo2install-[build-date].jar).
  • Open up a terminal window and go into the directory where the installer jar file is located.
  • Run the following command to install Kojo (replace installer-jar-file-name below with the actual name of the file that you downloaded): java -jar installer-jar-file-name
    • For a non-GUI install, add -console at the end of the above command.
  • Optionally download the Media files.
  • After Kojo is installed, you can run it from the Desktop (if you were prompted for, and installed, Desktop shortcuts). You can also run it by going into the bin sub-directory under the Kojo install directory, and running: ./kojo
Unix release notes | Mac release notes

Media Files

Media files are useful for working with the multiple turtle/sprite support in Kojo. Many different backgrounds, costumes, and sound files are available in the Scratch Media Bundle. To use these files, download the media bundle zipfile and unzip it under your home directory. You can then access the media files from inside Kojo using their absolute path, or their path relative to your home directory. For more information, visit the Media Notes page.

Troubleshooting

More information on troubleshooting installations...

Pre-requisites

You need to have Java 7 (preferred) or Java 6 installed on your machine to be able to run Kojo. To check the version of Java that is available on your machine, open up a command prompt and run the following command:

java -version

The reported version should be greater than 1.6.0_10. If it is not, please do the following:

Go to the Java download page and download and install the latest version of the JRE (Java Runtime Environment) for your Operating System. The x86 (i.e. 32 bit) version of the JRE installer is preferred (because GUI apps currently run faster on 32 bit JREs).

If in doubt, just go ahead and install the latest version of Java from the link above. This will make any Java based applications that you use (including Kojo) - run faster and better.

If you skip the Java download/install step, and if you later encounter problems while installing or running Kojo, the most likely culprit is a problem with your Java installation. In such a situation, you are requested to:

  • Download Java from the link above - and Install it.
  • Reinstall Kojo.
More information on troubleshooting installations...