backlog

znc-backlog is a ZNC module that makes it easy to request backlog. Its intended use is for when you have just launched your IRC client and gotten a few lines of backlog sent to you, but want to read more. Instead of having to deal with shelling into the box where you run ZNC and manually sifting through the logs, you can issue a short command in your IRC client to request any amount of the most recent lines of log.

Setup

You can get this module's source code here. Read the README for information on compiling and installing.

At the moment you must specify a log path manually:

/msg *backlog LogPath /path/to/your/logs/$USER_$NETWORK_$WINDOW_*.log

$USER will be replaced with your ZNC username, $NETWORK with the current network and $WINDOW with the requested channel/window name. The last found asterisk character '*' in the string is assumed to be a date, and the order in which the files are read is determined by a simple alphabetical sort. (ie. date format order must be year-month-date)

Optionally, you may specify this path as an argument to the module.

Usage

After the module is loaded and LogPath is set, you can request for logs with:

/msg *backlog <window-name> [num-lines]

e.g.

/msg *backlog #znc 42

[num-lines] is optional and defaults to 150.

Commands

Help (print this text)
LogPath <path> (use keywords $USER, $NETWORK, $WINDOW and an asterisk * for date)
PrintStatusMsgs true/false (print join/part/rename messages)

Tips

In weechat, you can create an alias to make requesting logs for the current window easier:

/alias bl msg *backlog $channel $1

Now you can:

/bl 42

or just:

/bl