JSIS

JavaScript IRC Stats

JavaScript IRC Stats … IRC Stats Reborn

What is JSIS?

JSIS is short for JavaScript IRC Stats. In short, it's a Node.js application that generates static web-pages for displaying IRC channel usage statistics.

If the word "IRC" means nothing to you, it's quite likely this application will be completely useless for you.

What kind of data does it show?

JSIS collects and shows many different statistics, below is a list of some.

  • Daily activity graph
  • Most active times graph
  • Most active nicks
  • Most active nicks by hour
  • Big numbers (most questions, smileys, etc.)
  • Most used words
  • Smileys
  • Most referenced URLs
  • Latest topics

Why was JSIS created?

I grew bored of looking at the old stats generated with pisg, and the other generators. I then thought I'd make my own stats program, with a more modern feel to it, and a more modern looking output.

The code in JSIS should also be somewhat easy to manage, and themeing should be pretty easy, if you get sick of the default theme. There's a widget system for adding content areas, e.g. "Most referenced words" in a somewhat simple way.

Where to get it from?

The code can be downloaded from the GitHub project page. GitHub also hosts the Wiki, and issue tracking. The JSIS homepage at JSIS.name serves as a place to publish documentation etc. in a better format.

Is it "ready", or "stable"?

Stable and ready are both relative terms. Is it ready? ... probably never will be, as the requirements keep growing as features are finished. Is it stable? If I commit, it doesn't crash for me. There's still a lot more to code, and many features need heavy "fine tuning" to generate better statistics.

Is it usable? It should be, assuming it happens to support the log format you need.

Some features that aren't ready:

  • Automatically following nicks through nick changes etc. (something has been done, but doesn't produce great results)
  • Configurable user details (gender, picture, link, etc.)
  • Statistics about nick usage, etc.
  • Rendering some graphic of when top users are active
  • Better lists of foul words, aggressive words, smileys, etc.
  • You can't have too many themes, so more themes should be made. It's easy, trust me like a politician.
  • A few of the widgets have gotten place holders, but the actual implementation is missing, some might require other features before they can be finished
  • Check out for any obviously missing features from pisg, fisg, mIRCStats, etc., try and come up with new ones

What log formats are supported?

At the moment, JSIS supports the default log formats (with optional seconds in timestamps) of:

  • Eggdrop
  • Irssi

Some clients etc. are pretty dumb and alter the log format based on themes etc., you might find help with cleaning them up to a format that can be parsed in the Wiki.

License

If you've stuck here for this long, you might be interested of the licensing of this awesome creation. Worry not, my friends, this thing is open source.

JSIS itself is released under two licenses: new BSD, and MIT. You may pick the license that best suits your development needs. The exact text of both licenses are provided with the source code.

However, you should note that the Rgraph graphing library bundled with the default theme does NOT allow free commercial use. If for some reason you'd be using this to graph your company's IRC channel statistics, then you'll have to buy a license for Rgraph, or better yet, create a theme that uses some other graphing library. More information about Rgraph licensing.

Installation and usage

Please refer to the documentation.