How to get started using Crunchy

Introduction

Here is a short guide to starting out with Crunchy, feel free to add suggestions and comments along the way. This is based on Crunchy version 0.8a.

Installation

Before you can use Crunchy, you need to download and install it. This is very simple because Crunchy doesn't need any Administrator/root privileges to run or install.

First you need to download the latest version of Crunchy, you can find it under the downloads tab above.

From here on in he procedures are slightly different for Windows and Linux, so I'll describe them separately.

Windows

Before you can use Crunchy on Windows, you will need to install Firefox and Python.

Once you have those dependencies, extract the Crunchy zip file into some convenient directory. Use Explorer to navigate to that directory and go into the crunchy sub-directory. Now all you need to do is double click on crunchy.py and Crunchy will load and open a new browser window.

Ubuntu Linux

Note: These instructions should be more or less correct for all nix systems.

Ubuntu already comes with suitable versions of Python and Firefox installed, so you can proceed straight to installing Crunchy itself. This is really very simple, all you need to do is extract all the files in the archive you downloaded to some directory (I just used my home directory).

Because of a bug in Ubuntu's version of Python you have to open Fireox before starting Crunchy: do so now.

Open a terminal and navigate to the directory you extracted Crunchy into, then run the following command:

$ python crunchy.py

Crunchy will be automagically opened in a new Firefox tab.

Experiencing Crunchy

By this point you should have a working version of Crunchy up and running. There are a few things you could do now, but I suggest having a look at the Using Crunchy section in the Tutorials menu.

If you're interested in creating Crunchy Compatible tutorials, take a at Tutorials -> Making Crunchy Tutorials -> How to... in the menu.