About the project

superseriousstats is a small and efficient program written in PHP to create a Web page with statistics out of various types of IRC logs. Data is stored incrementally using either SQLite or MySQL, therefore only logs containing new chat activity need to be parsed on any consecutive run. superseriousstats automatically continues where it last left off. The program is capable of generating statistics for IRC channels of any size and volume. It is also quite suitable to run at an increased frequency, for example once every hour or even less!

Be sure to check out one of the examples.

Documentation and support

A comprehensive guide on how to set up the latest version of superseriousstats is available, please read it carefully. For questions, bug reports and feature requests you are welcome to join us in #superseriousstats on chat.freenode.net. We will be more than happy to help you get the program running.

Software license

superseriousstats is released under the ISC license. This is a permissive free software license.

Copyright (c) 2007-2014, Jos de Ruijter

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Download code and releases

The most recent release is version 7.1, which was released on Februari 12, 2014. This release makes use of the SQLite RDBMS. A full list of changes can be found in the commit log on GitHub, as per usual.

Version 5.1 is the last release to support MySQL and can be downloaded from the source repository by checking out tag "v5.1". Documentation. A community effort to keep the MySQL branch of superseriousstats updated with the latest changes from the SQLite branch can be found here.

GitHub hosts a repository of all the files and sources related to superseriousstats. This would be the ideal place to start if you want to participate in or create your own fork of the project. See the commit log for a full list of changes between versions.

Motivation and beginnings

Around 1998 and late to the game, roughly ten years after it was invented, I discovered IRC. It didn't take long before I found myself hooked and keeping up an active session 24/7. Like many others I started playing around with bouncers, bots, mIRC scripts (hey, everybody did it!) and also stats generators. I ran shareware mIRCStats on an NT4 box for two of the channels I was in. Later switched to PISG, and although awesome, it yet again felt like something was missing.

By the end of 2002 me and some buddies were discussing "wouldn't it be cool if" and before we knew we were hacking code. I had already been thinking about picking up some kind of programming language to broaden my virtual abilities and PHP seemed like a good fit. It offered a good integration with the Web and setting up a MySQL database backend wasn't all that hard either. We named the project HOT IRC Stats which is an acronym of our IRC nicks: Humi, Orion and tommyrot.

For years the project was a chaotic mess of scripts, scheduled tasks and manual triggers. It took many, many iterations (and a lot of nagging) before the project was in a state where it could be released. Since I was the only one left who was actively working on the project I decided that a new name was in order, inspired by a quote from South Park and ofcourse being a generally good description of the project itself: superseriousstats!

I hope people enjoy my little program and perhaps find use for parts of my code in their own projects. Spread the word, it's free entertainment! We're on IRC if you want to say hi or discuss the project.