3.2. Standalone Installation of the IDE

Table of Contents

3.2.1. Installing the IDE on Windows
3.2.2. Installing the IDE on Linux
3.2.3. Installing the IDE on macOS

You only need to download and install the IDE as described in this section if you installed the Squish Tools from source.

If you have downloaded a Squish  binary package, the IDE is already included. The IDE's executable is SQUISHDIR\squishide.exe on Windows, SQUISHDIR/squishide on Unix, and SQUISHDIR/squishide.app on macOS.

The IDE is provided in a ZIP file called squishide-version.zip. The version may vary, but will include text that identifies its target platform (“win32”, “macosx”, and so on). Download the ZIP file that is appropriate for your platform and then follow the platform-specific installation instructions given below.

The IDE uses the Eclipse libraries, so Eclipse users will find themselves at home straight away. If you are unfamiliar with Eclipse, we recommend going through one of the Squish tutorials, or at least reading the Perspectives and Views sidebar. (See also, the IDE Reference Manual (Chapter 8).)

3.2.1. Installing the IDE on Windows

Once the IDE package is downloaded, unzip it in any convenient folder. You can probably uncompress the package using Window's built-in utilities. Start Windows Explorer and navigate to the folder that contains the IDE package. Right-click the package, and if you get an Extract All... option, click the option and use the Windows Extraction Wizard to uncompress the IDE package to the folder of your choice. If you don't have this option, you will need to obtain a ZIP uncompression tool. Several such tools are available, including the commercial WinZip and the open source UnZip from the InfoZip project.

The IDE's executable is in the unzipped folder's root and is called squishide; it can be run straight away from a console window:

C:\> cd squishide
C:\squishide> squishide.exe

For regular use you might prefer to create a shortcut to the executable from your Start menu or from your desktop.

[Note]The First Time the IDE Runs

The first time the IDE is run it will ask you to choose the folder where the Squish tools are located. Choose the Squish tools' toplevel folder, i.e., the folder that contains the bin and lib folders.

Depending on your security settings, Windows might pop up a dialog asking if you want to allow or block the squishserver from running. If you get this dialog, you must choose Unblock for Squish to be able to function correctly.

3.2.2. Installing the IDE on Linux

Once the IDE package is downloaded, unzip it in any convenient directory. (If you don't have unzip, install it using your system's package management tool.)

The IDE's executable is in the unzipped directory's root and is called squishide; it can be run straight away from an xterm:

$ cd squishide
$ ./squishide &

[Note]The First Time the IDE Runs

The first time the IDE is run it will ask you to choose the directory where the Squish tools are located.

3.2.3. Installing the IDE on macOS

Once the IDE package is downloaded, unzip it in any convenient directory.

The IDE's executable is in the unzipped directory's root and is called squishide; it can be run straight away from inside a Terminal.app:

$ cd squishide
$ open squishide.app

[Note]The First Time the IDE Runs

The first time the IDE is run it will ask you to choose the directory where the Squish tools are located.