Violentmonkey is a userscript manager for the Firefox 52+, Chrome, Chromium, Opera web browser, written by gera2ld.

Installing Violentmonkey

To get userscripts going with the desktop version of Violentmonkey, first you have to install it from the Firefox Add-ons website.

From the Violentmonkey page in the Firefox Add-ons website, click the green "+ Add to Firefox" button to install the extension. Once Violentmonkey has finished installing, you should see a pop-up confirming that Violentmonkey has been added to Firefox. This should point to a new Violentmonkey icon at the top of the Firefox window, next to the address bar.

Installing Userscripts

Once Violentmonkey is installed, installing userscripts from OpenUserJS.org is simple. Navigate to the OpenUserJS page for the script, then click the blue "Install" button at the top of the page.

Violentmonkey will display a screen showing you the source code of the userscript. Click the "Confirm installation" button to finish installing the script.

Installing userscripts from other sources is a similar process. You just need to find the installation link for the script. This will be a button or link to a file with a name that ends ".user.js"

After installing a userscript, you won't normally notice any further changes until you visit, or refresh, a website that it runs on.

Managing Userscripts

Clicking on the Violentmonkey icon at any time will pop up a menu that shows you what userscripts are running on the website you are looking at. You can enable or disable each one by clicking on its name (ticks mark enabled userscripts). The menu also lets you disable userscripts in general, or manage the scripts you have installed.

Clicking "Open Dashboard" in the Violentmonkey menu takes you a dashboard screen that lists all your installed scripts. Each one can be temporarily disabled or removed totally using the buttons provided. You can also manually check for updated userscripts.

Trouble shooting

If you think a userscript is causing problems, the easiest way to check is to switch off Violentmonkey, reload the web page, and see if the symptoms go away. You can do this by clicking on the Violentmonkey icon then clicking "Scripts enabled"; the tick next to the menu item should disappear and the monkey icon will turn grey. If it looks like a script problem and you have more than one script running on a web page, you can disable all of them in Violentmonkey's dashboard then re-enable them one by one until you find the culprit. Remember to reload the web page each time - userscripts normally only run when a web page loads.

Sometimes, when you use more than one userscript on the same web page, they need to run in a particular order. You can change the order using the Violentmonkey dashboard. Click and drag the bounding box of each script in the list to move it up or down in the list.

Sometimes, usually on a portable device, it may look like the userscript manager is not working. Try closing all tabs and load them fresh.

More

• Get Violentmonkey from the Firefox Add-ons website
• Violentmonkey IO - some documentation for Violentmonkey.