Quassel IRC

h1. Quassel Logging

Quassel saves all logs into the database, it never forgets backlogs unless you delete a buffer. You can either scroll back in chat windows as far as you like, or you can use a tool to dump or view the logs in plaintext format.

h2. Tools

h3. dumplog

this tool (written in Python) dumps quassel logs to a file. Currently it exports mIRC format.
You can get it at

> http://tier.schokokeks.org/quassel/dumplog-0.0.1.tar.bz2

it is rather self-explanatory, telling you if something went wrong. you can run it with

*default database path (ok for most unixes)*
<pre>python dumplog.py -u username -n network -c "#channel" -o channel.log</pre>

*custom database path (Windows etc.)*
<pre>python dumplog.py -d "C:\Quassel\quassel-storage.sqlite"</pre>

**Examples:**
>*show users in quasseldb*
><pre>python dumplog.py</pre>
>
>*show networks for quassel user john*
><pre>python dumplog.py -u john</pre>
>
>*show channels for network Freenode for user john*
><pre>python dumplog.py -u john -n Freenode</pre>
>
>*dump channel #quassel on network Freenode for user john to file quassel.log*
><pre>python dumplog.py -u john -n Freenode -c "#quassel" -o quassel.log</pre>

*Limitations / Known Issues* *Note*
dumplog currently only handles sqlite databases, postgres shouldn't be too hard if requested though.
nasty charset conversion takes place, gonna be fixed soon
topics will only be properly parsed with English logs, need to talk with Sput/EgS about that ;P

*Note* requested.
this tool is not maintained by quassel staff, contact Gentle on Freenode for bugs or feature requests