NAME

logger - RDF IRC Chat Logger


SYNOPSIS

  logger [options...] PASSWORD CHANNEL-URI CHANNEL-TITLE LOG-DIR LOG-URI > logger.log

An irc logger bot that automatically generated logs for various IRC chat channels. Call it with parameters above where

  PASSWORD      Administrator password for some commands
  CHANNEL-URI   IRC channel URI like irc://host[:port]/channel
  CHANNEL-TITLE A title to use in welcome messages
  LOG-DIR       Root directory to start writing logs
  LOG-URI       URI of where the logs appear on the web

and options are:

  -html          Write an XHTML log as well as text and RDF.
  -log LOGFILE   Write logs to LOGFILE rather than the default
                 of CHANNEL/YYYY-MM-DD (".txt", ".html", and ".rdf"
                 will be appended)
  -nick NICK     Use IRC nick NICK
  -noaction      Do not log /me messages
  -noofftopic    Do not ignore lines starting with [off]
  -userhosts     Record user@host from /join messages


DESCRIPTION

The logger bot listens to the chat channel and records it in public logs which are written live in three formats - RDF, plain text and HTML (usually created from RDF via XSLT by some other program).

Logger accepts a few commands that can be done publically with logger, COMMAND or privately with /msg logger COMMAND

The full list of commands can be found by the help command /msg logger help

Logger can be told to stop listening/recording to the chat, if for some reason this is required. For individual messages this can be done by putting the phrase '[off]' at the start of a line of text and for longer conversations, tell logger to stop listening with: logger, off and recording again with logger, on (there are other synonyms). The on/off messages are logged, as well as all public commands to logger. This feature can be turned off with -noofftopic

The current log URI, and the position in it can be queried at any time with logger, pointer or using one of the other aliases: here, bookmark, where am i?

The current log URI can be recorded in a particular chump bot item using: logger, chump D to record the discussion below item D.

Logger has some administrative commands that can be found from: /msg logger adminhelp

These require the startup password in order to use, for example this will make logger terminate: /msg logger password PASSWORD quit

logger will attempt to reconnect when disconnected but doesn't yet handle all network problems very gracefully.

LICENSE

GNU GPL version 2 or later - see http://www.gnu.org/copyleft/gpl.html

AUTHOR

Dave Beckett

with lots of changes from Ralph Swick - http://www.w3.org/People/all#swick, W3C/MIT