NAME

unscoop — import IRC logs

SYNOPSIS

unscoop

[-v] [-N network] [-c context] [-d path] [-f format] file ...

unscoop

-D [-d path]

DESCRIPTION

The unscoop utility imports plain text IRC logs into the litterbox(1) database. Network and channel or query names can be inferred from file paths, so unscoop should be run from the log directory root.

The current path being imported is printed to standard output. Progress based on total file size is printed to standard error.

The arguments are as follows:

-D

Delete duplicate events from overlapping imports and exit. This operation requires SQLite version 3.25.0 or newer.

-N network

Override the network name of the imported logs.

-c context

Override the channel or query name of the imported logs. Names beginning with ‘#’ or ‘&’ are assumed to be channels.

-d path

Set the database path, which must have been initialized by litterbox(1). The default path is as in litterbox(1).

-f format

Set the input log format. The default is generic.

-v

Print SQL INSERT statements on standard error.

The formats are as follows:

catgirl

Import logs from the catgirl(1) IRC client.

find ~/.local/share/catgirl/log \
	-type f -name '*.log' -print0 |
xargs -0 unscoop -f catgirl

generic

Import logs using generic matchers. Network and context names are inferred from paths of the form network/context/*. Events of the following formats are matched:

[timestamp] <nick> privmsg
[timestamp] -nick- notice
[timestamp] * nick action

irc

Import logs formatted as IRC protocol messages tagged with server-time. The network and context must be set with -N and -c.

textual

Import logs from the Textual IRC client.

find Textual -type f -name '*.txt' \
	-not -path '*/Console/*' -print0 |
xargs -0 unscoop -f textual

weechat

Import logs from the WeeChat IRC client.

find ~/.weechat/logs -type f -name 'irc.*.weechatlog' \
	-not -name 'irc.server.*.weechatlog' -print0 |
xargs -0 unscoop -f weechat

unscoop is not able to correctly infer network and context names for channel names containing dots. Import these logs explicitly with -N and -c.

znc

Import logs from the znc(1) log module.

find ~/.znc/moddata/log \
	~/.znc/users/*/moddata/log \
	~/.znc/users/*/networks/*/moddata/log \
	-type f -name '*.log' \
	-not -path '*/status/*' -print0 |
xargs -0 unscoop -f znc

SEE ALSO

litterbox(1)

AUTHORS

June McEnroe <june@causal.agency>

BUGS

Send mail to <list+litterbox@causal.agency> or join #ascii.town on irc.tilde.chat.