IRCv3 support

StarChat requests the capabilities below when the server offers them. Without them it falls back to plain IRC, so every server works, but some functions are only available with the matching capability.

Capabilities

Capability Used for
sasl Login with PLAIN (account and password) or IRCV3BEARER (token, see Embedding with login).
message-tags Reactions, replies and typing indicators.
server-time Correct times for history and delayed messages.
echo-message Own messages come back with their ID, needed to react to, reply to or delete them.
account-tag The account of the sender on every message, so a nick alone is never trusted.
batch Grouping of history and multiline messages.
away-notify Away state in the nick list without polling.
chathistory or draft/chathistory Loading earlier messages when opening a channel or scrolling up.
draft/event-playback Joins, parts and quits in the history as real events.
draft/message-redaction Deleting messages.
draft/multiline Messages with several lines.
draft/read-marker Read position shared by all sessions of an account.
draft/metadata-3 or draft/metadata-2 Avatars and status of users, the voice chat a user is in (key voice).
draft/webpush or soju.im/webpush Push notifications for logged-in accounts while no client is connected. In the browser it needs the pushWorker option (Push notifications), apps need the push feature of the network.

Client tags

Tag Used for
+draft/react, +draft/unreact Emoji reactions to a message.
+draft/reply Answers to a specific message.
+typing Shown when other users type.
+getstarchat.net/call, +getstarchat.net/call-id Ringing for voice calls between friends (feature calls), sent as TAGMSG to the nick.

Reactions and replies are offered only when the server does not deny the tags with CLIENTTAGDENY in ISUPPORT.

Calls

+getstarchat.net/call carries the step of the call, +getstarchat.net/call-id a random id of up to 32 letters and digits that keeps two calls apart.

Value Sent by Meaning
invite caller It should ring. The caller is already waiting in the voice room.
ringing callee It rings here. Without it within 6 seconds the caller assumes a client without calls and gives up.
unavailable callee Voice is switched off here.
busy callee Already in a call or another one rings.
accept, decline callee The answer. Other sessions of the same account see it as echo and stop ringing.
cancel caller Gave up before an answer.
end either Hung up.

Only invites from friends ring (by account tag, otherwise by nick). Calls publish no metadata.

Tested servers

StarChat is developed against Ergo, which supports all of the above. Other servers work with the subset they offer.

Edit this page on GitHub