Version 15 (modified by anonymous, 8 years ago) (diff)


IRC Logs Plugin

Notice: This plugin is unmaintained and available for adoption.


Display logs of an IRC channel in trac

Bugs/Feature Requests

Existing bugs and feature requests for IrcLogsPlugin are here. If you have any issues, create a new ticket.

Download and Source

Download the [download:irclogsplugin zipped source], check out using Subversion, or browse the source with Trac.


Run "easy_install" for 0.10.4 trac installations (not supported)

Run "easy_install" for 0.11+ trac installations

Run "easy_install" for cutting edge beta version (0.11+ trac)

The IrcLogsPlugin 0.11 depends on the python indexer. The beta version doesn't require pyndexter, but it will be needed for search capability. (It is installed automatically by easy_install)

Configuration 0.11

In your trac.ini file add these:

Under [Components], add:

 irclogs.irclogsplugin = enabled

Under [irclogs], add:

 path = /path/to/log/file/ChannelLogger 
 indexer = builtin:///var/www/trac/indexer/irclogs.idx?cache=true
 prefix = #roomname

For 0.11 add this to [irclogs]:

 path = /path/to/log/file/ChannelLogger 
 indexer = builtin:///var/www/trac/indexer/irclogs.idx?cache=true
 file_format = #roomname.%Y%m%d.log
 navigation_button = irclogs

This module was written assuming the use of supybot logs. You will need to configure your supybot to output in the correct format (these are not the default for supybot):

 config supybot.log.timestampformat %Y-%m-%d %H:%M:%S |
 config supybot.plugins.channellogger true
 config supybot.plugins.channellogger.directories false
 config supybot.plugins.channellogger.filenametimestamp %Y%m%d
 config supybot.plugins.channellogger.rotatelogs true

The 0.11 version of the plugin expects a different timestampformat:

 config supybot.log.timestampformat %Y-%m-%dT%H:%M:%S

To (re)index your log files, use this pydexter indexing python script. Be sure to edit the two variables for file locations in the script.

Note: In order to enable indexing for 0.11, you'll currently need a patch, see comment:ticket:1183:6.

Wiki Macros 0.11


Show conversation excerpts from IRC logs:


This macro takes two arguments: a UTC date formatted to UTCYYYY-MM-DDTHH:MM:SS, and (optional) the number of lines to display relative to the first message.

Link to an IRC conversation:

[irclog:UTC2008-02-11T18:03:27 View this conversation]

"Live" Log

Show a "live" AJAX log display. Note: This macro should be used sparingly; it should not be on the front page of a project in most cases.


This macro optionally takes two arguments: the first argument is the polling frequency in seconds (default is 60), the second argument is the number of lines to display (default is 10).


Recent Changes

7149 by doki_pen on 2009-11-16 15:19:06
don't be an idiot.

only window.location.href = window.location.href if
there's a hash.

7103 by doki_pen on 2009-11-06 21:17:38
Added hash refresh after css loading
6652 by doki_pen on 2009-10-06 14:33:03
Js bug fix. Fixes bug that caused entire page to be highlighted if url hash was


Maintainer: doki_pen
Author: mitsuhiko
Contributors: pacopablo


[23:42] <Rica|Coding> Someone know the IRCLogs plugin ?
[23:43] <Rica|Coding> (and have some info about it... nothing interresting on the wiki page...) Should the log be available before processing ? or Does the plugin connect to some channels ?
[23:43] <pacopablo> Rica|Coding: it just renders logs
[23:43] <pacopablo> specifically supy bot logs
[23:44] <Rica|Coding> ^^ok
[23:44] <pacopablo> you'll need a bot to creat the logs before the plugin is sueful

Attachments (1)

Download all attachments as: .zip