Welcome

Work in progress!

Hello new user, and welcome to Greasemonkey. This page is shown to you only once, the first time that you install Greasemonkey. It should help you get to know what Greasemonkey is, how it works, and how you can get help if you're having a problem. You can continue reading the Greasemonkey Manual for more information.

User Scripts

Getting Scripts

You can get user scripts anywhere on the internet. However, the most common place is [1], which has been operating since 2005 and now contains tens-of-thousands of scripts. There is also an active user scripting community at userscripts.org.

Problem Troubleshooting

Much like Firefox allows you to install extensions, Greasemonkey allows you to install user scripts. If you are having a problem with Greasemonkey, first it is important to check if the problem is actually with the user script, just like a problem with Firefox may actually be caused by an extension.

If you're having trouble, and you think Greasemonkey is the problem you can try these troubleshooting steps. (These steps can always be found in the Troubleshooting (Users) page, with more detail.)

Enable Greasemonkey (all scripts)

If you're missing a feature you are used to having, click Tools, Greasemonkey and make sure "Enabled" is checked.

Disable Greasemonkey (all scripts)

If something about a site used to work, but is now broken, click Tools, Greasemonkey and make sure "Enabled" is unchecked.

Disable just scripts selectively

If disabling all scripts helped, try figuring out which script is causing the problem. Click Tools, Greasemonkey, Manage User Scripts..., then for every script, uncheck the "Enabled" check box below the list. If the problem went away, re-enable the scripts one-at-a-time. If enabling one script causes the problem, you've found the culprit!

Check for errors

If disabling a script helps, there's probably a problem with that script that needs to be fixed. Click Tools, Error Console. In this new window, click Clear, then load the problem page. If new lines appear in the error console, that's very valuable information. You can select them and Copy their text.

Disable Greasemonkey (the whole extension)

If nothing else helps, you can try completely disabling the entire Greasemonkey extension. Click Tools, Add-Ons, find and pick Greasemonkey, and click the Disable button. Restart Firefox.

Problems with a Script

If the troubleshooting steps above identified one script with a problem, then you might be able to get it fixed! The best thing to do is find the original author of that script, and get them to fix it. If you installed your script from userscripts.org you should be able to find the author listed there. The userscripts.org site also has general forums for script support, which might be able to point you to the right place.

Getting Help

If you're having problems, you should always A) start with the list above and B) be prepared to explain what you've already done, and what the results were. Without that information, even someone who wants to help you can only, at best, guess. You'll have to type all this information out sooner or later, so doing it ahead of time makes things easier for you and someone who might help, and therefore makes it more likely that someone will be willing to help.

To find assistance, there are three good places to look:

• Mentioned above, problems with one user script should be brought to the attention of that script's author.
• If you are the author of the script, or otherwise still need help, you can turn to the greasemonkey-users mailing list.
• Also available are the forums at userscripts.org, with multiple appropriate topics.