.Dd July 24, 2020
.Dt README 7
.Os "Causal Agency"
.
.Sh NAME
.Nm litterbox
.Nd IRC logger
.
.Sh DESCRIPTION
.Xr litterbox 1
is a TLS-only IRC logger.
It logs events from IRC in a SQLite database,
indexing messages for full-text search.
It is intended for use with
the IRC bouncer
.Lk https://git.causal.agency/pounce pounce ,
but can also be used independently
as a logging bot.
.
.Pp
.Nm
provides the
.Xr scoop 1
command-line query utility.
A web interface for
.Nm
is provided by
.Lk https://git.causal.agency/scooper scooper .
.
.Sh INSTALLING
.Nm
targets
.Fx ,
.Ox
and Linux,
and requires LibreSSL
.Pq Fl ltls
and SQLite
.Pq Fl lsqite3 .
An
.Xr rc 8
script for
.Nm
is provided on
.Fx .
.Bd -literal -offset indent
\&./configure
make all
sudo make install
.Ed
.
.Pp
If LibreSSL is installed
in a non-standard path, set
.Ev PKG_CONFIG_PATH appropriately.
For example:
.Bd -literal -offset indent
PKG_CONFIG_PATH=/opt/libressl/lib/pkgconfig ./configure
.Ed
.
.Sh FILES
.Bl -tag -width "litterbox.c" -compact
.It Pa database.h
database functions and schema
.It Pa litterbox.c
IRC logging
.It Pa scoop.c
query building and output formatting
.It Pa unscoop.c
log file processing
.It Pa config.c
.Xr getopt_long 3 Ns -integrated
configuration parsing
.It Pa rc.d/
.Fx
.Xr rc 8
scripts
.El
.
.Sh CONTRIBUTING
The upstream URL of this project is
.Aq Lk https://git.causal.agency/litterbox .
Contributions in any form can be sent to
.Aq Mt list+litterbox@causal.agency .
For sending patches by email, see
.Aq Lk https://git-send-email.io .
.
.Sh SEE ALSO
.Xr litterbox 1 ,
.Xr scoop 1 ,
.Xr unscoop 1
.
.Bl -item
.It
IRC bouncer:
.Lk https://git.causal.agency/pounce pounce
.It
Web interface:
.Lk https://git.causal.agency/scooper scooper
.It
.Rs
.%A June Bug
.%T IRC Suite
.%U https://text.causal.agency/010-irc-suite.txt
.%D June 19, 2020
.Re
.El