Project

General

Profile

Quassel Logging » History » Version 4

Gentle, 03/15/2009 09:10 PM
known problems added

1 1 Gentle
h1. Quassel Logging
2 1 Gentle
3 1 Gentle
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.
4 1 Gentle
5 1 Gentle
h2. Tools
6 1 Gentle
7 1 Gentle
h3. dumplog
8 1 Gentle
9 1 Gentle
this tool (written in Python) dumps quassel logs to a file. Currently it exports mIRC format.
10 1 Gentle
You can get it at
11 1 Gentle
12 1 Gentle
> http://tier.schokokeks.org/quassel/dumplog-0.0.1.tar.bz2
13 1 Gentle
14 1 Gentle
it is rather self-explanatory, telling you if something went wrong. you can run it with
15 1 Gentle
16 1 Gentle
*default database path (ok for most unixes)*
17 1 Gentle
<pre>python dumplog.py -u username -n network -c "#channel" -o channel.log</pre>
18 1 Gentle
19 1 Gentle
*custom database path (Windows etc.)*
20 2 Gentle
<pre>python dumplog.py -d "C:\Quassel\quassel-storage.sqlite"</pre>
21 1 Gentle
22 1 Gentle
**Examples:**
23 1 Gentle
>*show users in quasseldb*
24 1 Gentle
><pre>python dumplog.py</pre>
25 1 Gentle
>
26 1 Gentle
>*show networks for quassel user john*
27 1 Gentle
><pre>python dumplog.py -u john</pre>
28 1 Gentle
>
29 1 Gentle
>*show channels for network Freenode for user john*
30 1 Gentle
><pre>python dumplog.py -u john -n Freenode</pre>
31 1 Gentle
>
32 1 Gentle
>*dump channel #quassel on network Freenode for user john to file quassel.log*
33 1 Gentle
><pre>python dumplog.py -u john -n Freenode -c "#quassel" -o quassel.log</pre>
34 1 Gentle
35 4 Gentle
*Limitations / Known Issues*
36 4 Gentle
dumplog currently only handles sqlite databases, postgres shouldn't be too hard if requested though.
37 4 Gentle
nasty charset conversion takes place, gonna be fixed soon
38 4 Gentle
topics will only be properly parsed with English logs, need to talk with Sput/EgS about that ;P
39 4 Gentle
40 3 Gentle
*Note*
41 1 Gentle
this tool is not maintained by quassel staff, contact Gentle on Freenode for bugs or feature requests