irclog2html 2.9.2

Convert IRC logs to HTML

Converts IRC log files to HTML with pretty colours.

Quick start

Installation:

pip install irclog2html

Quick usage for a single log file:

irclog2html --help
irclog2html filename.log                  (produces filename.log.html)

Mass-conversion of logs (one file per day, with YYYY-MM-DD in the filename) with next/prev links, with mtime checks, usable from cron:

logs2html directory/            (looks for *.log, produces *.log.html)

CGI script for log searching

Warning

The script can be easily abused to cause a denial of service attack; it parses all log files every time you perform a search.

You can generate search boxes on IRC log pages by passing the --searchbox option to logs2html. Here’s an example Apache config snippet that makes it work:

RewriteRule ^/my-irclog/search/$ /my-irclog/search [R,L]
ScriptAlias /my-irclog/search /usr/local/bin/irclogsearch
<Location /my-irclog/search>
  SetEnv IRCLOG_LOCATION "/var/www/my-irclog/"
</Location>

Misc

Website: http://mg.pov.lt/irclog2html/

Bug tracker: https://bugs.launchpad.net/irclog2html

Licence: GPL v2 or later (http://www.gnu.org/copyleft/gpl.html)

Changelog

2.9.2 (2011-01-16)

• Support XChat Latin/Unicode hybrid encoding (http://xchat.org/encoding/). Fixes LP#703622.

• irclog2html copies irclog.css file into the destination directory. Fixes LP#608727.

2.9.1 (2010-08-06)

• Make sure irclog.css is installed in the right place; logs2html needs it.

2.9 (2010-08-06)

• Restructured source tree, made irclogs2html into a package, added setup.py, buildout.cfg, bootstrap.py, Makefile, HACKING.txt; moved old porting test suite into a subdirectory (porting).

• logs2html copies irclog.css file into the destination directory.

• Released into PyPI.

2.8 (2010-07-22)

• Added README.txt and CHANGES.txt.

• Support dircproxy log files (new date format: “[15 Jan 08:42]”, strip ident and IP address from nicknames). Patch by Paul Frields.

• New option: –dircproxy also makes irclog2html strip a single leading ‘+’ or ‘-’ from messages.

2.7.1 (2009-04-30)

• Bug in logs2html.py error reporting, reported by Ondrej Baudys.

2.7 (2008-06-10)

• New style: mediawiki. Patch by Ian Weller.

2.6 (2007-10-30)

• Support another date format (Oct 17 10:53:26). Patch by Matthew Barnes.

2.5.1 (2007-03-22)

• logs2html.py: add a stable link to the latest log file (suggested by Chris Foster).

2.5 (2007-01-22)

• New option: –searchbox.

• Search CGI script improvements (e.g. put newest matches on top).

2.4 (2006-12-11)

• Added a sample CGI script for brute-force log searches.

2.3 (2005-03-08)

• Use xhtmltable style by default.

• Added a copy of the navbar at the bottom.

2.2 (2005-02-04)

• Support supybot’s ChannelLogger date format (e.g. 02-Feb-2004).

• Fixed broken timestamp hyperlinks in xhtml/xhtmltable styles.

• CSS tweaks.

2.1mg (2005-01-09)

• Ported irclog2html.pl version 2.1 by Jeff Waugh from Perl to Python.

• New styles: xhtml, xhtmltable.

• New options: –title, –{prev,index,next}-{url,title}

• Removed hardcoded nick colour preferences for jdub, cantaker and chuckd

• Bugfix: colours are preserver accross nick changes (irclog2html.pl tried to do that, but had a bug in a regex)

• Added ISO8601 timestamp support (e.g. 2005-01-09T12:43:11).

• More careful URL linkification (stop at ‘, “, ), >).

• Added logs2html.py script for mass-conversion of logs.

• Added support for xchat log files.

• Added xchatlogsplit.py script for splitting xchat logs on day boundaries so they’re suitable as input for logs2html.py.