Install package, then run and enjoy! Junbuster accepts only one command line option -- the configuration file to be used. Example Unix startup command:
# /usr/sbin/junkbuster /etc/junkbuster/config & |
If no configuration file is specified on the command line, Junkbuster will look for a file named config in the current directory. Except on Amiga where it will look for AmiTCP:db/junkbuster/config and Win32 where it will try junkbstr.txt. If no file is specified on the command line and no default configuration file can be found, Junkbuster will fail to start.
Be sure your browser is set to use the proxy which is by default at localhost, port 5865. With Netscape (and Mozilla), this can be set under Edit -> Preferences -> Advanced -> Proxies -> HTTP Proxy. For Internet Explorer: Tools > Internet Properties -> Connections -> LAN Setting. Then, check "Use Proxy" and fill in the appropriate info (Address: localhost, Port: 5865). Include if HTTPS proxy support too.
The included default configuration files should give a reasonable starting point, though may be somewhat aggressive in blocking junk. You will probably want to keep an eye out for sites that require cookies, and add these to actionsfile as needed. By default, most of these will be blocked until you add them to the configuration. If you want the browser to handle this instead, you will need to edit actionsfile and disable this feature. If you use more than one browser, it would make more sense to let Junkbuster handle this. In which case, the browser(s) should be set to accept all cookies.
If a particular site shows problems loading properly, try adding it to the {fragile} section of actionsfile. This will turn off most actions for this site.
HTTP/1.1 support is not fully implemented. If browsers that support HTTP/1.1 (like Mozilla or recent versions of I.E.) experience problems, you might try to force HTTP/1.0 compatiblity. For Mozilla, look under Edit -> Preferences -> Debug -> Networking. Or set the "+downgrade" config option in actionsfile.
After running Junkbuster for a while, you can start to fine tune the configuration to suit your personal, or site, preferences and requirements. There are many, many aspects that can be customized. "Actions" (from actionsfile) can be adjusted by pointing your browser to http://i.j.b./, and then follow the link to "edit the actions list". (This is an internal page and does not require Internet access.)
In fact, various aspects of Junkbuster configuration can be viewed from this page, including current configuration parameters, source code version numbers, the browser's request headers, and "actions" that apply to a given URL. In addition to the actionsfile editor mentioned above, Junkbuster can also be turned "on" and "off" from this page.
If you encounter problems, please verify it is a Junkbuster bug, by disabling Junkbuster, and then trying the same page. Also, try another browser if possible to eliminate browser or site problems. Before reporting it as a bug, see if there is not a configuration option that is enabled that is causing the page not to load. You can then add an exception for that page or site. If a bug, please report it to the developers (see below).