Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How to convert a bookmarklet into a Greasemonkey userscript?

Is there a easy way to do this. And is there anything that needs to be changed due to differences in how it is ran?

like image 603
Bigandrewgold Avatar asked Aug 02 '11 00:08

Bigandrewgold


1 Answers

The easiest way to do this:

  1. Run the bookmarklet code through a URL decoder. so that javascript:alert%20('Hi%20Boss!')%3B, for example, becomes:
    javascript:alert ('Hi Boss!');

  2. Strip the leading javascript: off.   Result: alert ('Hi Boss!');

  3. Add this code to the end of your Greasemonkey file. For example, create a file named,
    Hello World.user.js, with this code:

    // ==UserScript==
    // @name            Hello World!
    // @description     My first GM script from a bookmarklet
    // @include         https://stackoverflow.com/questions/*
    // @grant           none
    // ==/UserScript==
    
    alert ('Hi Boss!');
    
  4. Open Hello World.user.js with Firefox (CtrlO ).   Greasemonkey will prompt to install the script.

  5. Now the bookmarklet code will run automatically on whatever pages you specified with the @include and @exclude directives.

  6. Update: To ensure maximum compatibility, use the @grant none directive that was added in later versions of Greasemonkey and Tampermonkey.


IMPORTANT:

  • The userscript will run much sooner than you could ever activate a bookmark. Normally, this is not a problem.

  • But in some cases, you might need to wait for some part of the page to fully load.
    In that case, you can use techniques/utilities like waitForKeyElements.

  • See also, Choosing and activating the right controls on an AJAX-driven site .

  • If you still can't get your new script to work, be sure to read My very simple Greasemonkey script is not running?. Follow the steps and include the specified information in any question you open about problems with the new script.

like image 90
Brock Adams Avatar answered Oct 05 '22 11:10

Brock Adams