0.0 Latest Announcements

Safari 5.1

PithHelmet 3 does not work with Safari 5.1 in any way. This is related to the new multiprocess page rendering and it makes it substantially more annoying to get PithHelmet working. It may be possible to emulate most of PithHelmet with a real Safari extension, but that will take more time and in the end, be much slower. I'm investigation a few existing extensions to see if they actually block requests correctly in all circumstances. I'll post here when I know more.

I should note that this is not a problem with SIMBL. Plugins still work, but the details of how Safari is now implemented make it tougher to get working nicely.

Safari 5.0

This works just fine - install the following:

1.1 What It Does

PithHelmet is an extended site preferences and ad blocking plugin for Apple's Safari browser. The basic purpose of the plugin is to empower you the user to view the web as you like. You can block ad images, Flash, Shockwave or horrible midi loops - the world is your oyster.

1.2 More Detailed Information

Progress reports are regularly written to the PithHelmet Development section of my development log. One of these days I will get around to hosting the source somewhere, but for now, inquiring minds can send me a quick email and get the latest branch.

2.1 Installing and Upgrading

PithHelmet is a plugin for SIMBL. This keeps PithHelmet from unintentionally interfering with other applications, such as the screen saver.

PithHelmet is distributed as a metapackage and installed by Apple's Installer.app. The PithHelmet.mpkg file will automatically update or install the lastest version of SIMBL and the PithHelmet plugin. The installed components are listed below.

The actual PithHelmet.bundle will now be installed in the /Library/Application Supports/SIMBL/Plugins folder.

If you have added you own rules, they will get saved in a backup file in ~/Library/Application Support/PithHelmet before they are automatically upgraded.

2.2 Uninstalling PithHelmet

Removing (trashing) the PithHelment.bundle from /Library/Application Support/SIMBL/Plugins folder will effectively remove PithHelmet from Safari.

2.3 Installed Files and Folders

3.1 How To Block A URL

Once you've installed the files, start Safari (restart it if it's been running during the install process). Try browsing a few sites and you should see markedly less advertisements. (I like cnn.com or msn.com for a good demo site)

If some undesirable content isn't blocked, you can add it to the "block list" in one of the following ways:

You can test the rules on a particular URL by clicking the "Show Rule Tester" button. That will give you some information about whether or not the url was blocked or allowed, and for what reason. Once you close the rules editor or click the Apply button, the new rules will be active.

3.2 How To Allow A URL

If some desirable content is accidentally getting caught by the Block rules (a false positive), you can specifically allow content via an Allow rule. The method is similar to adding an Block rule, simply add the rule and under the filter tab select "Allow" instead of "Block". Allow rules are applied only after an Block rule has been matched.

You can use the same testing method described in the previous section.

3.3 How To Build Better Blocking Rules

PithHelmet has a test panel (accessibly via the rule editor) which will give you an explanation of what exactly PithHelmet thinks about a specified URL.

In addition, the curious user can enable the PithHelmet.log file (from the preferences pane) and all urls matching a rule will be logged to this file.

4.0 Quick Explanation of the Preferences Pane

5.0 Quick Explanation of the Rule Editor

6.0 Quick Explanation of Menu Items and Keyboard Shortcuts

7.0 Questions | Comments | Feedback

Please feel free to contact me via email - I'm interested to here your criticisms and thoughts.

You can always read about the latest PithHelmet status in my development journal. There are also a number of pages on the PithHelmet section of my collaborative web site, Wikir.

If you enjoy PithHelmet, please take a moment to register your copy.

8.0 Revision History

v2.8.4 - released 2008-11-26

v2.8.3 - released 2008-04-26

v2.8 - released 2007-11-05

v2.7 - released 2007-08-05

v2.6.7 - released 2006-06-28

v2.6.6 - released 2006-05-18

v2.6.5 - released 2006-03-04

v2.6.4 - released 2005-01-14

v2.6.3 - released 2005-12-31

v2.6.2 - released 2005-11-01

v2.4.2 - released 2005-11-01

v2.6.1 - released 2005-08-07

v2.6 - released 2005-08-01

v2.5.2 - released 2005-06-01

v2.5.1/v2.4.2/v2.3.3 - released 2005-05-05

v2.5 - released 2005-04-29

v2.4.1 - released 2005-04-27

v2.4 - released 2005-04-18

v2.3.2 - released 2005-04-27

v2.3.1 - released 2005-04-17

v2.3 - released 2005-03-21

Show Complete History