ZNC website has died on 29 March 2017, without fresh backups. Wiki is now back from dump of July 2015. Please help restoring the lost content.
| This module is a part of ZNC.
This module is shipped with ZNC by default. If you have the right "LoadMod" you can activate it with
The code for this module can be found here.
This module logs your conversations to some special place on your disk.
In the znc-0.206 release this module is NOT a core module, see ZNC-Extra for more information on how to use it
Since ZNC 1.2, this module mimics directory permissions set on its data directory (moddata/log, in whatever location appropriate to the mode it is running in; see above) when creating new subdirectories. However, as of 2013-08-20, umasks may interfere with it and result in less access being granted than expected. For example, the module may be unable to grant write access to Group or World (umask 0022).
To get the directory permission inheritance under ZNC 1.0, use this file and
znc-buildmod log.cpp, then move the module to the ZNC modules directory.
This user module takes one through three arguments.
-sanitize If presented, removes color codes and C0 control codes from the lines before logged.
-timestamp If presented, permits manually specifying a timestamp that will be passed through
Third argument: Relative path where to store logs. It can contain
$WINDOW tokens as well as time format tokens.
Depending on the scope in which the log module is loaded, the path argument is relative to the following paths: (Note:
~/.znc/ might be different if you use a non-standard data directory):
global: ~/.znc/moddata/log/ user: ~/.znc/users/$USER/moddata/log/ network: ~/.znc/users/$USER/networks/$NETWORK/moddata/log/
Default paths since 1.6:
global: $USER/$NETWORK/$WINDOW/%Y-%m-%d.log user: $NETWORK/$WINDOW/%Y-%m-%d.log network: $WINDOW/%Y-%m-%d.log
Default paths prior 1.6:
global: $USER_$NETWORK_$WINDOW_%Y%m%d.log user: $NETWORK_$WINDOW_%Y%m%d.log network: $WINDOW_%Y%m%d.log
To convert your old logs to the 1.6 format, you can use this user created script. If you want to log to some other place, make a symlink.
Read loading modules to learn more about loading modules.
Load the module to start logging, unload it to stop logging. Kinda easy, eh?
- Clear all logging rules
Help <search term>
- Generate this output. Optionally search for a given word/phrase.
- List all logging rules
Set boolean(added in 1.7)
- Set one of the following booleans: joins, quits, nickchanges.
- For example,
/msg *log Set quits falseto exclude quit messages from the log.
- Filter chat rooms which should be logged (all by default). Use
!queryto negate and
The log module uses the "energymech" format so it can be used with pisg if so desired.
<channel="#znc"> # Before ZNC 1.6.0 Logfile = "/home/znc/.znc/users/efnet/moddata/log/#znc_*.log" # Since ZNC 1.6.0 LogDir="/home/znc/.znc/moddata/log/user/efnet/#znc" Format = "energymech" Network = "EFnet" OutputFile = "znc.html" </channel>