Projects / ReferrerCop


ReferrerCop parses Apache log files and AWStats data files and removes entries for referring URLs that match a list of known referrer spammers. Logs can be run through ReferrerCop either before or after they're processed by AWStats (or before they're processed by any other log analyzer) to eliminate annoying referrer spam from Web statistics.

Operating Systems

Recent releases

  •  03 Mar 2006 09:23

    Release Notes: The format of blacklists and whitelists has changed slightly. Performance with large lists has been improved. The blacklist update feature is now more reliable.

    •  18 Oct 2005 07:09

      Release Notes: A new command-line option was added to automatically download blacklist updates and a bug in the filtering of AWStats data files was fixed.

      •  06 Oct 2005 10:18

        Release Notes: An in-place filtering mode was added and the parsing of AWStats data files was improved.

        •  18 Jun 2005 04:12

          Release Notes: Filtering performance was improved by over 300%, new command line options were added for extracting URLs from filtered files, and the Ruby API was improved.

          •  10 Jun 2005 09:25

            Release Notes: Wildcards and multiple files may now be specified on the command line. Malformed lines in Apache logs are handled gracefully. Several new command-line options were added.

            Recent comments

            10 Jun 2005 07:25 suso

            Nothing against your software, its great that you wrote it. But just a comment about the fact that it had to be written. Its unbelievable that its coming to this. Having to write programs to match advertisements that are being put into webserver log files through referal headers. What is our precious little internet coming too.

            Having received some "referer spam" myself, once I realized what it was, I was less inclined to do any business with the refered site. I guess they are counting on less technical people who read their stats to follow the links. Sigh. I digress.

            One thing about this though that makes it different from email spam is that you can be pretty sure that you can send a message back to the spammer by putting a long message in the URL that you go to to get to the refered site, like this:



            Project Spotlight


            A Fluent OpenStack client API for Java.


            Project Spotlight

            TurnKey TWiki Appliance

            A TWiki appliance that is easy to use and lightweight.