== !GlimmerBlocker: a more stable ad-blocker == Download for OSX 10.7 and 10.8: [[GlimmerDownloadFinal(foobar)]]. Download for OSX 10.5 and 10.6: [http://glimmerblocker.org/downloads/GlimmerBlocker-1.4.16.dmg GlimmerBlocker-1.4.16.dmg] ([http://glimmerblocker.org/wiki/ReleaseNotes/1.4.16 release notes]). When installing !GlimmerBlocker, you might be prompted to install Java. Some users need to re-run the !GlimmerBlocker installer after the java installer is done. [wiki:Uninstall Easy to uninstall] if you don't like it anyway. !GlimmerBlocker is free: No payments required, but please help spread the word as ad-based sites would very much like to keep it a secret:  [[GlimmerSocial()]] [wiki:ScreenShots Screenshots gallery] and [wiki:Installation detailed installation] help. === Compatibility === Parental controls: There is a bug in Lion's parental controls, which breaks using any kind of http proxy. You need to [https://bugreport.apple.com/ report this problem to Apple] as they're the only one who can fix the bug. The more reports, the more likely Apple is to fix the bug. There exist no version of !GlimmerBlocker for 10.4 (Tiger). == About !GlimmerBlocker == The problem with other ad-blockers for Safari is that they are implemented as awful hacks: as an !InputManager and/or !ApplicationEnhancer. This compromises the stability of Safari and very often create problems when Apple releases a new version of Safari. [http://www.icoretech.org/2009/08/block-ads-in-safari-64-bit-mode-on-snow-leopard/ Snow Leopard doesn't support the InputManager-based blockers] when Safari runs in 64-bit mode. !GlimmerBlocker is implemented as an http proxy, so the stability of Safari isn't compromised because it doesn't use any hacks. It is even compatible with all other browsers and other native Mac OS X applications which uses http, e.g. !NetNewsWire. The proxy runs on the mac and not on a central server like most proxies. You'll always be able to upgrade Safari without breaking !GlimmerBlocker (or waiting for a new release); and you'll be able to upgrade !GlimmerBlocker without upgrading Safari. This makes it much easier to use the beta versions of Safari and especially the nightly builds of [http://webkit.org/ WebKit]. Because !GlimmerBlocker doesn't hack Safari, there is a few things it isn't able to do: adding a block by right-clicking an image, stopping pop-unders, and filtering cookies from 3rd party sites. But you win a lot in stability, and !GlimmerBlocker provides much easier methods for adding your own modifications to pages by adding css rules, pieces of Javascript or by transforming the html before Safari receives it. So I'll hope you're happy with the tradeoff. If you can program in Javascript you'll be able to add your own modification to pages. See the included filters for examples, e.g. adding a download link to !YouTube. [http://tollethesen.wordpress.com/2009/01/14/werbefrei-browsen-in-mac-os-x/ Guido's description of GlimmerBlocker in German], and [http://code.google.com/p/china-gb-filter/ Fingster Kevin's description and filter] for Chinese users. == Share your filters == A set of default filters for common worldwide ad-providers are included in !GlimmerBlocker. So out-of-the box it blocks most ads. If you still see ads on common, high-traffic sites, please [mailto:feedback@glimmerblocker.org notify me] so the filters can be improved. You can create your own filters and publish them using !MobileMe or plain !WebDav so other users can subscribe to your filter. See the [wiki:Filters list of filters] which other users have published. {{{ #!comment A filter for Danish websites is provided at: !http://glimmerblocker.org/site/filters/danish-sites.xml }}} You can [wiki:iPhoneiPodProxy setup iPhone/iPod] to use !GlimmerBlocker when they're using wifi. == How to develop advanced filters == In addition to just blocking ads, !GlimmerBlocker can add css or javascript to the pages, can modify the content using Javascript, can modify the request before !GlimmerBlocker sends it to the remote server, can specify which dns-server or http/socks5 proxy that !GlimmerBlocker must use when fetching that specific URL. Documentation: * [wiki:Flow request & response flow] * [wiki:Transform2 modify content] before Safari receives it. * [wiki:KeywordExpansion keyword expansion] * [wiki:ObjectReference object reference] * [wiki:Proxies proxies] and dynamic dns configuration. * [wiki:TipsAndTricks Tips & Tricks] == Application workarounds == The following applications needs workarounds or configured: * [wiki:GoogleDrive Google Drive is buggy] and the usual workarounds doesn't work, only a single non-recommended hack does. * Firefox works fine with !GlimmerBlocker, but since it doesn't use the system-wide proxy settings for Mac OS X by default, you need to [wiki:Firefox configure Firefox] manually. * [wiki:LittleSnitch configure Little Snitch]. * [wiki:MicrosoftMessenger setup Microsoft Messenger]. * workaround for [wiki:NortonLiveUpdate Norton Live Update]. * workaround for [wiki:TinyGrab TinyGrab]. * [wiki:OpenDNS-IPv6 OpenDNS and IPv6] for e.g. ipv6.google.com * Miro doesn't work with proxies. See Miro bug [http://bugzilla.pculture.org/show_bug.cgi?id=7061 #7061] == Miscellaneous == Very short [wiki:FAQ FAQ]. !GlimmerBlocker is fully open source and is licensed using [http://www.gnu.org/licenses/gpl.html GPLv3]. You can [wiki:Download download the source], make your own modifications, submit changes, etc. Older versions can be found in the [/downloads/ downloads] directory. Sparkle uses two rss feeds: [/site/rss/sparkle-final.xml official releases] and [/site/rss/sparkle-beta.xml beta releases]. Even though the rss feeds includes a link to the new version, the easiest method to update !GlimmerBlocker is to open the "System Preferences", choose !GlimmerBlocker and click "check now" in the "Setup" tab pane. Send feedback and bug-reports to [feedback@glimmerblocker.org]