Sualtam

Table of contents

What is Sualtam?

Sualtam is an IRC channel archive generator. You give him the name of a channel, and it automagically creates archives of the discussions that take place on that channel. Here is an example archive.

What is Sualtam not?

Sualtam is not a log parser, like most other IRC archive generators. It is a "bot". That is, it will connect to the channel, record everything that happens, and produce nice html pages that contain the archive. This approach has several advantages over log parsers:

It is easy to record 24/24. Just start Sualtam on a machine connected to the net. With a log parser, you would only have archives of the time your irc client was running.

Configuration is trivial. You could probably manage to get an irc client permanently connected, and a log parser to run in the background. But that would be much more work, since neither are designed for that purpose. On the other hand, Sualtam is the irc client. So it is very easy to configure, and it can generate the archive in realtime.

Sualtam appears as a user on the channel, by default with the name log. So the other users are aware that the conversation is being recorded. No eavesdropping.

Sualtam is not a full featured (did somebody say: bloated?) IRC bot. It will not take care of controling the channel. It will not say anything funny or clever in the channel. Actually, it will not say anything at all. It will just listen.

Sualtam does not generate usage statistics about the channel. But maybe it will in the future.

How do I use Sualtam?

One HTML file will be created for each day which had activity on the channel.
You can customize the appearance of the logs by putting a file named
sualtam.css in the same directory. You can use the
example style sheet as a starting point.

You may also generate a index.html as overview for all
logfiles. Therefore you need the flag
--genIDX. Sualtam will then (re)generate the
index.html when it is needed.

If you want to force (re)generation of the index.html
use: java -jar sualtam.jar --createIDX (process
will exit right after generation).

There is now also a timezone option that let you choose
which timezone to use in the logs.

Run java -jar sualtam.jar --listtz to see
which timezones are available at your installation.

At sualtam startup use the option --timezone
"Australia/Brisbane" to choose which timezone to use.