Greasemonkey Manual:Manage Dialog

From GreaseSpot Wiki
Jump to: navigation, search
Greasemonkey Manual
Using Greasemonkey
Installing Scripts
Script Management
Monkey Menu
Getting Help
User Script Authoring
Other Useful Tools

This page is out of date, and only useful for historical reference. It describes the script management dialog in versions of Greasemonkey before 0.9.0.

The Dialog

GM Manage Dialog

At the left is a screenshot of the Greasemonkey manage dialog. This is the interface that is used to control the user scripts that have been installed.

On the left in this dialog is the list of installed scripts. Selecting any script will display its name and description on the right, as well as the set of include and exclude rules that apply to that script. Any script that is enabled will be shown in black text, while those that are disabled will appear in grey. Select the script and check or uncheck the enabled box below the list to control whether it is currently enabled or disabled.

Beside the enabled checkbox is the edit button. Click this button to edit the currently selected script, by launching the text editor on the installed file. The first time that a user edits a script like this, Greasemonkey will open a browse dialog to allow choosing of which text editor to use. If a user is having trouble with this button, they should read the appropriate section of the FAQ.

Beside the edit button is the uninstall button. This is the way to remove any script that has been installed. To the right of the uninstall button is the checkbox that controls what happens to the saved preferences of scripts that are removed. Greasemonkey provides a mechanism for user scripts to store values, similar to cookies for web pages. Checking this box will make these stored values be removed along with the script. (Leaving the box un-checked will keep the values around, but unused. This may be useful if the user expects to install the same script again in the future.)

Opening the Dialog

It is important to know how to open the Manage User Scripts dialog. This can be achieved in several ways:

  • It can be found by clicking in the menu bar of Firefox under Tools → Greasemonkey → Manage User Scripts...
  • The same menu item may be found in the monkey menu.

Porting pre-0.9.0 changes to post-0.9.0 versions

Since changes made within this dialog were not ported to 0.9.0+ versions automatically, one must perform the following steps in order to preserve their @include/@exclude lists.

  1. Locate the scripts directory (gm_scripts directory within the Firefox profile).
  2. Within that directory, there is a config.xml file; copy it to a safe place
  3. Open the copy in your favourite text editor (as the original will be overwritten automatically in following steps)
  4. For each userscript listed (a <Script> element),
    1. copy the items in the <Include> elements into @include lines in the userscript itself,
    2. copy the items in the <Exclude> elements into @exclude lines in the userscript itself.