Installation

Windows Installation

Unzip the contents of the ZIP file that you have just downloaded to a new directory.

You will have 6 files:

• Squeak.exe (the Squeak Virtual Machine)
• SqueakX.changes (the changes file)
• SqueakX.image (the image file)
• SqueakX.sources (the sources file)
• SqueakFFIPrims.dll
• WelcomeSqueakS

("X" represents the current Squeak version, e.g. Squeak3.9-final-7067.image)

To run Squeak, drag the image file (e.g. Squeak3.9-final-7067.image) on top of the Squeak virtual machine: Squeak.exe.

To make double clicking the image file open Squeak you have to right click the image file, then select the menu option 'open with'. Then you have to locate the SqueakVM on the hard disk and select the option to always use SqueakVM to open files with .image suffix.

You can also double click on Squeak.exe and be asked for an image file.

Mac Installation

• First, download the mac release which is a zip folder. If you have set Safari appropriately this folder will unzip automatically after the download, else just unzip it by double clicking on it (on OSX).
• The folder contains all the files you need. You can put the folder somewhere on your hard disk and drag the .image file on the .app file and thats it.
• Alternatively you can pick the .app file (this is the Squeak Virtual Machine for the Mac, including lots of plugins) and put it in the Application folder so that when you'll double click an .image file Squeak will start automagically.

Note: to see the plugins select the .app file while pressing the CTRL key. In the context menu select 'Show Package Contents'. Open the 'Contents' folder, the plugins are in the 'Resources' folder.

Linux Installation

Please see Unix Squeak page for more information on Linux distributions. For Debian, see the Debian installation instructions on the Squeak Wiki.

Seaside Installation 

The homepage for the Seaside web framework is here. 

Download Seaside 3.0.6:

• Easy Install (recommended for new users)

Download Seaside 2.8:

• Easy Install (recommended for new users)
• Expert Install (just the image and changes)

YouTube videos for installing Seaside: 

• Installing Seaside 3.0
• Installing Seaside 2.8.3

Troubleshooting

Don't be afraid to ask questions in different Squeak Forums online.

If you have trouble starting Squeak for the first time, try the following:

By far the most common problem is that the files were downloaded in "text mode". The symptom is that a compressed ".sit" file can't be decompressed. This is because add of the linefeeds have been turned in to carriage returns. The downloading program is trying to do too many favors for you. Another symptom is that Squeak runs, but the source code of every method is gibberish. This means the file SqueakV3.sources had linefeeds inserted into it.

In both your fetching utility, and your decompressing program, set the preference to "binary" instead of "text" mode.

Download a complete set of all files you need. Make sure these files are OK and are not touched by any download problems. I recommend downloading a Stuffit, Zip, or Tar file (depending on your preferred platform) since the compressed files usually have checksums. Uncompressed files are sometime modified by helpful OSs, and this corrupts it for Squeak. If you download stuff from the web you should always do binary download. If you don't know how to do this, use Fetch, or another FTP program.

Look what's happening. If you get messages such "Squeak could not find the file xxxxxx" then you haven't put all of the files in the same folder. In general, you must not get such a message. If you do, something is wrong.

If you use the Browser and the bottom pane is blank, it means that Squeak cannot find the .sources file. Perhaps it is not in the same folder as the image and the virtual machine.

Try the graphics/sound examples in the "Welcome to Squeak" Window.