UNSCOOP(1)

💅 UNSCOOP(1) — the import-IRC-logs girlie ✨

okay bestie, welcome to unscoop — General Commands Manual energy, but make it a group chat 🫶

---

🌸 NAME 🌸

unscoop — she imports IRC logs, that's her whole thing 💖

---

✨ SYNOPSIS ✨

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

---

🦋 DESCRIPTION 🦋

so the unscoop utility imports plain text IRC logs into the litterbox(1) database. that's it, that's the job, and she ate 🔥

here's the cute part: network and channel-or-query names can be inferred from file paths, so like... run unscoop from the log directory root, mkay? that's where the magic happens ✨

the current path being imported gets printed to standard output. progress based on total file size goes to standard error. two streams, two vibes, no drama 🎀

the arguments are as follows:

• -D — Delete duplicate events from overlapping imports and exit. ngl this one requires SQLite version 3.25.0 or newer, no cap. 💀
• -N network — override the network name of the imported logs 👑
• -c context — override the channel or query name of the imported logs. heads up: 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. default is generic ⭐
• -v — print SQL INSERT statements on standard error. yep, she'll spill everything 🙈

---

🧚 THE FORMATS (a whole menu, obsessed) 🧚

🍓 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 — like, non-negotiable bestie 🫶

💜 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

⚠️ okay so real talk: unscoop is not able to correctly infer network and context names for channel names containing dots. import these logs explicitly with -N and -c, periodt 💅

🌈 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)

that's the whole list, but it's an iconic list 💖

---

🫶 AUTHORS 🫶

June McEnroe <june@causal.agency> — queen behavior, we love her 👑

---

😭 BUGS 😭

send mail to ⟨list+litterbox@causal.agency⟩ or join #ascii.town on irc.tilde.chat 💌 — they're nice, promise 🧚

---

💀 final vibe check: this page is from Debian, dated May 18, 2021. mwah, that's the tea, go import some logs bestie 💅✨🎀