Junkbuster is a free proxy that runs on Linux to block out ads and other content on a page, that you don't feel like looking at. It saves bandwidth and speeds up loading of webpages by not downloading images you don't need. This Howto gives you the simple steps required to get Junkbuster working on PowerPC Linux. New in this version is the return of external proxy configuration info.


Installing the Package

You can download the PowerPC RPM from . After the package finishes downloading, type rpm -ivh junkbuster*ppc.rpm into a xterm. This will install the package.

If you are using Debian, it's even simpler, just run apt-get install junkbuster.

Installing the package will automatically startup Junkbuster.

Configuring Netscape to Use Junkbuster

Start up Netscape Communicator.

Open up the Preferences (It's found in Edit -> Preferences). Expand the Advanced item, by clicking the arrow. Click on Proxies.

Choose manual proxy configuration. Click Select. A new dialog will appear containing proxy information..

Put in the box next to 'HTTP Proxy:' the number 127.0.0.1. That tells Netscape the proxy is your own machine. Replace this with another machine name, if it's running not running on your own machine.

In the next box over, labeled 'Port' put in 8000 (if you are using the RPM) or 5865 (if you are using the dpkg).

If all went well, then Netscape should be able to browse the web. It won't block ads, until you configure it somemore (see below).

Getting Waldherr's Blacklist

Blacklisting is the process of blocking advertisements and other pages you do not wish to see when you are browsing the web.

Mr. Waldherr has created a list of common advertisements on the web, that you can use to blacklist. He has also created scripts that can be used to automatically update them for you.

The two scripts you need are and . Download them by right clicking on these links, and saving them to your home directory (~).

You need to become root. You can do this by su in a xterm.

Both junkbuster.monthly and junkbuster.weekly need to be executable by root. You can do this by typing in a xterm: chmod +x junkbuster.*ly.

Next, these files need to be moved the proper place. Copy junkbuster.montly into /etc/cron.monthly/. You can do this by: cp junkbuster.monthly /etc/cron.monthly. Copy junkbuster.weekly into /etc/cron.weekly/. You can do this by: cp junkbuster.weekly /etc/cron.weeklly.

Adding or Changing Entries in the Blacklist

Most likely Mr. Waldherr's blockfiles will blacklist something you don't want blacklisted or leave an ad you wanted blacklisted, showing.

You can control what is shown by junkbuster by editing (or creating) one of two files.

  • Edit or create /etc/junkbuster/blockfile.local to add webpages you want blacklisted with a "Blocked By Junkbuster" page.
  • Edit or create /etc/junkbuster/imagefile.local to add images you want blacklisted with a 1x1 clear GIF image.

    Rules for blacklisting:

  • Add pages/images to a blacklist by putting it's domain or path. Examples: ads.example.com or adimg/adserv*.pl?*foobar*.gif
  • You can whitelist (tell it not to block) images or pages by putting a ~ in front of a line. Examples: ~notanad.example.com or notadimg/notadserv*.pl?*foobar*.gif
  • You can use wildcards.
  • One entry per line.
  • Important! You must have a blank line at the end of both files, after editing. Otherwise the proxy won't work.

    After making these changes, they will be applied as soon as you load another page with the proxy. No need to restart junkbuster.

    Using Junkbuster with Another Proxy

    If you use another proxy besides Junkbuster, like one in an office or a school, or you use Squid on your machine to speed up your net connection (see here) you can add proxy support.

    Edit /etc/junkbuster/config/ to remove the hash/comment (#) before the forwardfile line (ie. replace #forwardfile /etc/junkbuster/forwardfile with forwardfile /etc/junkbuster/forwardfile).

    Add the name of the proxy you want to be used from inside junkbuster, in this case cache.example.com:3120 * cache.example.com:3120 . ..

    The first * represents what hosts you want to use this that proxy. In this case, I want all hosts to go through it. It is important to have the two periods at the end of the line, or it won't work. Also, don't forget to add an extra line at the end of this config file.

    Good luck, blocking ads and protecting your privacy. Send suggestions to .