Files
roro9stack/site/content/guide/irc.md
T
twislaandClaude Sonnet 5.5 2f1befa7f5
Site / build (pull_request) Successful in 8s
Site: the user guide (phase 2): the basics, one page per App, Settings and Updates
Eleven pages under /guide/, written from the README, the milestone documents
and the Apps' own source: the keys, the Launcher, the Status Bar and the first
start; the LoRa Scanner, GNSS, Gemini, IRC, Wi-Fi tools, Notes, Storage and
System; Settings (with Wi-Fi) and Updates. Real screenshots where the site has
them, a Guide link in the navigation, and the home page points to it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
2026-10-06 20:38:40 +02:00

3.0 KiB

+++ title = "IRC" description = "Chat on an IRC server from the keyboard, with a connection that outlives the App and daily logs on the SD card." weight = 5 [extra] tag = "IRC" +++

Connecting

The first time, type /settings and press Enter. The settings page has:

  • Server and Port, and TLS (on or off).
  • Self-signed: for a server whose certificate no authority signed. It is pinned on first use: the first certificate it sees is remembered, and a different one later is refused.
  • Nick, SASL user and SASL password, NickServ password: passwords show only as (set).
  • Auto-join: the channels to join after connecting.
  • Save & reconnect.

Opening the IRC App connects, if Wi-Fi is up. The connection belongs to a background service: leaving the App does not disconnect, and new messages keep arriving and being logged. It reconnects by itself after a drop, and does not start by itself after a restart.

Chatting

You type at the bottom; Enter sends. A line starting with / is a command:

Command Does
/join #channel [key] (or /j) Joins; the # is optional
/part [#channel] [message] Leaves
/msg nick text (or /query) Opens a private chat, sending the text if there is any
/me text An action line
/nick newnick Changes your nick
/topic [text] Shows or sets the channel topic
/names [#channel] Lists who is there
/quit [message] Disconnects and stays disconnected until you type something again
/raw … (or /quote) Sends a line to the server as it is
/settings The settings page

Each server, channel and private chat is a buffer. Tab moves to the next one, each shows how many messages are unread, and your own lines are in the accent colour. Scroll back with Alt + ; (older) and Alt + . (newer). The up and down arrows (Fn + ; and .) recall lines you sent.

Mentions and the unread count

A message with your nick in it, or any private message, is a mention: it shows a Toast over whatever App is open, and counts in the Status Bar's [n]. Other traffic only adds to the buffer's unread count.

Logs

Every buffer is logged to the SD card, one file per day, under /irc. Logs stop when the card passes 90% full, to keep the rest for captures; nothing is deleted without your asking, in the Storage App's Maintenance.

Good to know

  • IRC pauses while Wi-Fi is monitoring (the Status Bar shows MON) and while the device installs an update. It reconnects and rejoins its channels afterwards; the App says paused in the meantime.
  • A secure connection costs memory: IRC's takes about 40 KB of the 107 KB the device has, and an update's download needs about 52 KB more. That is why IRC steps aside for an update, and why the daily update check waits for IRC to be disconnected (see Updates).