about summary refs log tree commit diff
UNSCOOP(1) General Commands Manual UNSCOOP(1)

unscoopimport IRC logs

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

unscoop -D [-d path]

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:

Delete duplicate events from overlapping imports and exit. This operation requires SQLite version 3.25.0 or newer.
Override the network name of the imported logs.
Override the channel or query name of the imported logs. Names beginning with ‘#’ or ‘&’ are assumed to be channels.
Set the database path, which must have been initialized by litterbox(1). The default path is as in litterbox(1).
Set the input log format. The default is generic.
Print SQL statements on standard error.

The formats are as follows:

Import logs from the catgirl(1) IRC client.
find ~/.local/share/catgirl/log \
	-type f -name '*.log' -print0 |
xargs -0 unscoop -f catgirl
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
Import logs formatted as IRC protocol messages tagged with . The network and context must be set with -N and -c.
Import logs from the Textual IRC client.
find Textual -type f -name '*.txt' \
	-not -path '*/Console/*' -print0 |
xargs -0 unscoop -f textual
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.

Import logs from the znc(1) 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


June Bug <june@causal.agency>

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

May 18, 2021 OpenBSD 7.0