StopTheMadness for Safari Support

Email: stopthemadness@underpassapp.com

Home: Home Page

Help Topics:

Safari 13 and Catalina:
StopTheMadness has full support for Safari 13 and for macOS 10.15 Catalina. StopTheMadness is a Safari App Extension, which is the newer extension format now recommended by Apple. StopTheMadness is not affected by Apple's deprecation of the older .safariextz extension format.

Safari Technology Preview:
StopTheMadness is fully compatible with Safari Technology Preview. However, enabling StopTheMadness in Safari does not automatically enable it in Safari Technology Preview, so you'll need to enable StopTheMadness in Safari Technology Preview's Preferences.

How to Enable the Safari Extension:
See How to enable StopTheMadness in Safari for instructions on how to enable the extension in Safari.

If you're having trouble enabling the extension in Safari Preferences because the checkboxes don't respond to clicks, please see the article Safari bug: can't enable extensions on Catalina.

Privacy:
According to Safari's Preferences, StopTheMadness "Can read sensitive information from webpages, including passwords, phone numbers, and credit cards on all webpages" and "Can see when you visit all webpages". However, this is just boilerplate text from Apple shown for every Safari extension that can modify webpages. StopTheMadness does not read, use, or share your personal data. The privacy policy has more details about StopTheMadness privacy. See also my blog post The security of Safari extensions for a more detailed explanation of StopTheMadness permissions.

Refunds:
Apple can grant refunds for App Store purchases on request. App Store developers do not have the power to grant refunds, only Apple has that power. For instructions on how to request a refund, please see Apple's support article Request a refund for an App Store or iTunes Store purchase.

Contextual Menus:
By default, StopTheMadness stops web sites from disabling Safari's contextual menu. This is useful for example on YouTube, where Safari's contextual menu allows you to easily Enter Picture in Picture. If you still need to open a web site's custom contextual menu instead of Safari's contextual menu, just press the option key while you open the menu.

StopTheMadness inserts an "Open StopTheMadness…" item into Safari's contextual menu. This menu item opens the StopTheMadness app and gives you easy access to your settings. If you don't want this item to appear in Safari's contextual menu, select the "Install" tab of the StopTheMadness window and uncheck "Open StopTheMadness" in the "Safari Contextual Menu Items" section.

Optionally, you can add an item to Safari's contextual menu to open links in an alternative browser:

contextual menu item Open Link with

To enable this menu item, select a browser from the "Open Link with" popup menu in StopTheMadness. To disable the menu item, select the top empty row in the same popup menu.

popup menu Open Link with

If you have Link Unshortener installed, you can set it as the alternative browser. StopTheMadness and Link Unshortener were designed to work together.

Website Options:
You can selectively enable and disable StopTheMadness features. Your custom options can be configured to apply to every web page or just to web sites that you specify. To change the options, open the StopTheMadness app in the Applications folder, and select the Website Options tab.

StopTheMadness Website Options Tab

There are a number of protection features that you can enable and disable. By default, the "Recommended" features are enabled. These provide you with a high level of protection while also maximizing website compatibility. The features labeled "Use with caution" provide even higher levels of protection, but there may be more sites that don't work right when they're enabled, which is why they're disabled by default. Any and all of the features can be enabled or disabled as necessary or desired. Below is an explanation of each feature:

When you change the website options in StopTheMadness, those changes will apply the next time you load a web site in Safari. If you already have a web site open in Safari, and you want the changes to apply immediately to the web site, you need to reload the page in Safari.

How to Add Website Options:
The Default options for all websites apply to every web page in Safari, unless you have custom options for a particular site. To create custom options for a website, press the + button. There are two ways to specify websites: domain or URL. Examples of domains are "apple.com" and "google.com". If you specify a domain, then subdomains of that domain are automatically covered too. For example, "google.com" also covers "www.google.com", "mail.google.com", etc. If you want a subdomain to have different options than its domain, create a separate item for the subdomain. The longest match always wins, so if you have items for both "google.com" and "mail.google.com", then your "mail.google.com" options will apply when you load the page "https://mail.google.com/". If you want options to apply only to subdomains but not to the domain, put a dot at the beginning: ".google.com" applies to "https://www.google.com/", etc., but not to "https://google.com/".

You may want to apply custom options only to certain paths of a website, in which case you need to specify the website as a full URL. For example, if you enter "https://www.google.com/maps", then the custom options will only apply to Google Maps and not to Google Search at "https://www.google.com/". Subpaths are automatically covered too: "https://www.google.com/maps" would also cover "https://www.google.com/maps/search/apple+park". You can customize subpath options by creating a separate item for the subpath. As with domains, the longest match among URLs always wins. And a URL setting that includes a domain will override a domain setting for the same domain, since the URL is longer. So "https://www.google.com/maps" takes precedence over "www.google.com".

URL Scheme Rules and Web URL Rules:
See URL Scheme Rules and Web URL Rules for a detailed explanation of these tabs in the StopTheMadness window.

Migrate Safari Extension Settings to a New Mac:
To migrate your custom Safari extension settings to a new Mac, you can export them to a file on one Mac and then import the file on the other Mac. The Export and Import commands are in the main menu of StopTheMadness:

StopTheMadness main menu

The exported Safari extension settings include your Website Options, URL Scheme Rules, and Web URL Rules. The Website Options from other browsers, such as Firefox and Google Chrome, are not included.

Known Website Compatibility Issues:
In these cases you may want to create custom website options and disable the specific feature.

Home: Home Page