Ikariam Library

Installing a Greasemonkey Script

This step by step picture guide should help those that have issues getting Greasemonkey and Greasemonkey scripts installed and working. This starts at the very beginning with installing Firefox, all the way to seeing the script do its work.

Step 1: Requirements

Download the requirements. Firefox3 is available from Get Firefox. Greasemonkey from Install Greasemonkey.
Firefox3 and Greasemonkey 0.8.2

Step 2: Install Firefox3

Install Firefox. Run the Firefox installer and install Firefox.
New Firefox Installation

Step 3: Install Greasemonkey

Install Greasemonkey, to do this, simply drag the Greasemonkey file (greasemonkey-0.8.2*.xpi) into Firefox. The following popup should display, click "Install Now".
Install Greasemonkey

Step 4: Restart Firefox

Once installed, you will be prompted to restart Firefox. Click "Restart Now".
Restart Firefox

Step 5: Greasemonkey Installed

After Firefox has restarted, the Extensions window should display that Greasemonkey is installed.
Greasemonkey Installed

Step 6: Download Script

Now download the script you want to use from Ikariam Library. Due to the download method used you will be prompted to safe the file. This additionally allows you to have a local back up of the version you download. If the download does not start automatically, click the "click here" link and the download should start. If this is not the case, please contact the Ikariam Library Team.

Step 7: Drag and Drop

Installing the script once downloaded is done just how installing Greasemonkey was. Drag and drop the script into Firefox. Firefox can react to the drop in two ways described in steps 8 and 9.
Drag and Drop script

Step 8: Install Process 1

In this case, Firefox and Greasemonkey has recognised that the file is a script and has prompted you to install it. Feel free to view the script to ensure it is what you expect it to be. Furthermore you should confirm the sites in which the script is running on. If you choose to view the source, the script is not yet installed. You will be presented with the screen shown in step 9; continue the installation from that step.

Once the countdown has expired, click "Install"
Script to Install

Step 9: Install Process 2

In this case, Firefox has displayed the script before Greasemonkey caught it. The script is already displayed. As before, check that it is what you expected. Find the lines starting "// @include" and ensure only relative URLs are shown. There might be more than one include line so check carefully.

Once you are sure the script is safe, click "Install" at the top right.
View Source

Step 10: blah

Once you have clicked install in either of the above cases, Greasemonkey for a short time displays a installed message. Ensure this is successful.
Script Installed Successfully

Step 11: Confirm Script Installed

You can confirm the script is installed, and further check the sites in which it will run, but opening the Greasemonkey script manager. This is accessed by "Tools -> Greasemonkey -> Manage User Scripts...".

Scripts that are greyed out, are disabled. These scripts will not run on any page, and will need to be re-enabled to become active again.
Greasemonkey Script Manager

Step 12: Script Working

Now the script is installed and working, simply view a page that is included in the 'Included Pages' list and the effects of the script should be shown.
Working Script

Guide Comments

Comments and issues should be posted on the Forum Thread