About / Tampermonkey for Safari

Tampermonkey is a userscript manager extension for Android, Chrome, Chromium, Edge, Firefox, Opera, Safari, and other similar web browsers, written by Jan Biniok. There are also versions for Android, Chrome, Chromium, Edge, Firefox, and Opera.

WARNING!

Safari has end-of-life'd (EOL) .safariextz style extensions in version 13. Tampermonkey has made a notice at Tampermonkey/tampermonkey#558 (comment). If you have "Keep my software up to date" enabled on macOS you will be getting Safari 13 at any time and it will disable/remove Tampermonkey. It is currently, at the time of this notice, no longer available in the App Store. Please see the GitHub issue regarding potential intstallation methods if you have not upgraded Safari to version 13 and perhaps, meanwhile, an alternative.

Installing Tampermonkey

To get userscripts going with the desktop version of Tampermonkey, first you have to install it from Apple Safari Extensions.

Screenshot of Tampermonkey page in tampermonkey.net

From the webpage, click the text "Install". Upon completion a Tampermonkey icon should appear next to the address bar.

Installing Userscripts

Once Tampermonkey 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.

Screenshot of an OpenUserJS script page

Tampermonkey will display a screen showing you where the userscript has come from, what websites it can access, its source code, and a warning to only install scripts from sources that you trust. If you do want to install the script, click the "Install" button, otherwise click "Cancel".

Screenshot of Tampermonkey script installation

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 a website that it runs on.

Managing Userscripts

Clicking on the Tampermonkey icon at any time will pop up a menu that shows you what userscripts are running on the website you are looking at. It also lets you check for updated scripts (it does daily automatic checks by default), and open the Tampermonkey Dashboard.

Screenshot of Tampermonkey Dashboard

In the Dashboard, the "Installed userscripts" tab is the main place to manage your userscripts. The number to the left of each script shows you the order they run in, and whether they are enabled (green) or disabled (gray) - click it to toggle the status. You can also uninstall userscripts (trash can icon), check for new updates (click the "Last updated" date), and some other icons related to the script management.

Trouble shooting

If you think a userscript is causing problems, the easiest way to check is to switch off Tampermonkey, reload the web page, and see if the symptoms go away. You can do this by clicking on the Tampermonkey icon then clicking "Enabled"; the tick icon should change to a cross. If it looks like a script problem and you have more than one script running on a web page, you can disable them all in Tampermonkey'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 Tampermonkey dashboard. In the "Sort" column, click on the 'three lines' icon for the script you want to move, move the mouse up or down to change the order, then release.

More