chathistorysync(1)

📦 version 0.2.1, in alpine 3.24

💬 chathistorysync — bestie's guide to syncing ur IRC chat logs ✨

okay so first things first: this is the manual page for chathistorysync, from the General Commands Manual section, and it's literally gonna change ur chat-log life. sit down, grab a boba 🧋, we're doing this.

🌸 NAME 🌸

chathistorysync — a synchronization tool for IRC chat history 💖

like… it syncs. ur IRC history. that's the whole vibe.

🦋 SYNOPSIS 🦋

chathistorysync [options...] <remote> <dir>

that's it. options, then the remote, then the dir. slay. 👑

✨ DESCRIPTION ✨

so what it does: it synchronizes a local chat log directory with a remote IRC server. yes bestie, ur logs, on ur disk, kept in sync. iconic.

the chat log directory is formatted with the znc syntax — that's the format, periodt. and the server? it needs to support the draft/chathistory IRCv3 extension. no extension, no logs, iykyk. 😭

and get this — if the server also supports the soju.im/bouncer-networks extension, then the logs get fetched from the bouncer for each configured network. multi-network energy. main character bouncer fr fr. 🫶

now the incremental part, which is honestly the best bit: if chathistorysync has previously fetched logs into dir, running it again will incrementally fetch new logs. so it doesn't re-download everything like some kind of chaos demon. it just picks up what's new. ate. 💅

example time, copy it exactly bestie:

chathistorysync emersion@chat.sr.ht ~/chat-logs

look at that. beautiful. emersion@chat.sr.ht → ~/chat-logs. go off. 🎀

🎀 OPTIONS 🎀

  • -h, -help — shows the help message and quits. short version, long version, both valid. thoughtful king. 👑
  • -after <YYYY-MM-DD> — only fetches logs after the specified date. note the format: YYYY-MM-DD, exactly. so like 2026-10-14 vibes. don't get cute with the date format, bestie. 🗓️
  • -debug — enables debug logs. for when u need to see everything that's happening. detective mode. 🔍
ngl that's genuinely the whole options list. three entries. minimal queen. ✨

💜 AUTHORS 💜

maintained by Simon Ser <contact@emersion.fr>, who is assisted by other open-source contributors 🫶 — community effort, we love to see it.

for more info about chathistorysync development, see <https://sr.ht/~emersion/chathistorysync>. go look, it's giving source. 🌈

and that's the page, bestie 🦋 — this was chathistorysync(1) from the General Commands Manual, dated 2026-10-14, and no cap it's a whole vibe. mwah 💋

📦 where this page comes from