|README(7)||Miscellaneous Information Manual||README(7)|
litterbox — IRC
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 pounce, but can also be used independently as a logging bot.
litterbox provides the
scoop(1) command-line query utility. A web
litterbox is provided by
formats of plain text logs can be imported into the
litterbox database with
litterbox requires SQLite3 and
libtls, provided by either
(for OpenSSL) or by LibreSSL. It targets FreeBSD,
OpenBSD and Linux.
./configure make all sudo make install
If installing libtls manually to
/usr/local, for example, make sure
/usr/local/lib appears in
/etc/ld.so.conf.d/* and be sure to run
ldconfig(8) once the library is
./configure to find it.
On FreeBSD and
OpenBSD the recommended way to run
litterbox is with the process supervisor
- database functions and schema
- IRC logging
- query building and output formatting
- log file processing
- getopt_long(3)-integrated configuration parsing
- XDG base directories
The upstream URL of this project is ⟨https://git.causal.agency/litterbox⟩. Contributions in any form can be sent to <firstname.lastname@example.org>. For sending patches by email, see ⟨https://git-send-email.io⟩.
Monetary contributions can be donated via Liberapay.
litterbox(1), scoop(1), unscoop(1)
- IRC bouncer: pounce
- Web interface: scooper
June McEnroe, IRC Suite, https://text.causal.agency/010-irc-suite.txt, June 19, 2020.
|May 18, 2021||Causal Agency|