Xepher 2021-06-26 Xepher — WeeChat XMPP client Xepher — Client XMPP pour WeeChat WeeChat plugin for accessing XMPP, written in C++23. Requires WeeChat 4.3 or newer; source builds require matching development headers and CMake 3.22 or newer. This fork includes bug fixes and feature enhancements. en C++ Linux macOS (best-effort) FreeBSD (best-effort) OpenBSD (best-effort) NetBSD (best-effort) complete 1.4.0 Current Jabber OpenPGP Usage (deprecated but supported) complete 2.5.0 Service Discovery - server disco#items queried at connect time to find all components; disco#info sent to each component to detect upload services (XEP-0363), pubsub gateways (XEP-0060), and conference services (XEP-0045); pubsub components with identity category='pubsub' are stored in known_pubsub_services for /feed discover auto-enumeration; /disco summary prints cached domain/component capability matrix; summary auto-printed to account log ~6s after connect partial 1.35.5 Multi-User Chat (MUC) - join/leave, send/receive, IRC-style admin (/kick, /ban, /voice, /devoice, /op, /deop), owner config (/roomconfig full interactive server form on WeeChat 4.3+, /setmodes, /affiliation list|set, /destroy), interactive registration (/mucregister [nick], using jabber:iq:register with muc#register FORM_TYPE; /mucregister query displays current info), direct and mediated invites (/invite, /decline); history maxstanzas='0' on join (MAM catch-up). Interactive configuration and registration support submit/cancel with server acknowledgement, preserve hidden fields and multiple values, and retain answers after rejection. complete 1.2 Bookmark Storage partial 1.2 Private XML Storage (for bookmarks) partial 1.3.0 vcard-temp — /whois fetches and displays supported profile fields and photos; /setvcard edits fn, nickname, email, url, desc, org, title, tel, bday, and note while preserving other fields, photos, and additional email/phone entries. Updates are confirmed only after server acknowledgement. Auto-fetch triggered by XEP-0153 presence hash; no vCard PHOTO publishing. partial 0.12.0 vCard4 Over XMPP — fetch via /whois (PubSub IQ get + display); no publish support yet complete 1.1.4 User Avatar - receive/cache/display avatars; /setavatar publishes PEP avatar data and metadata and updates the local avatar hash used by subsequent XEP-0153 presences; does not publish a vCard PHOTO or immediately broadcast presence complete 1.5.0 Out of Band Data - display URLs shared in messages with optional descriptions complete 2.1 Chat State Notifications - all 5 states (active, composing, paused, inactive, gone) with visual indicators complete 1.1 Software Version - responds to version queries with client name and version complete 1.2.2 User Mood - publish and subscribe to mood updates via PEP complete 1.3 User Activity - publish and subscribe to activity updates via PEP complete 1.6.0 Entity Capabilities with persistent caching complete 1.2.2 Personal Eventing Protocol (PEP) - receives and logs events complete 1.1 User Nickname - publishes own nickname via PEP on connect; subscribes to nickname updates from contacts via PEP complete 1.2 SASL ANONYMOUS login via /account add --anon. The server assigns a temporary JID; no trace data is sent complete 1.4.0 Message Delivery Receipts complete 2.0.1 XMPP Ping complete 2.0 Entity Time - responds to time queries with UTC time and timezone offset complete 2.0 Delayed Delivery - proper timestamps for offline messages and MAM history complete 1.1 Persistent Storage of Private Data via PubSub - used for bookmarks, mood, and activity with publish-options complete 1.0.1 Message Carbons complete 1.2.1 Last Message Correction complete 1.1.3 Message Archive Management (MAM) v2 with persistent local caching; IQ routing fixed to address own bare JID for personal archive queries complete 1.0.2 Last User Interaction in Presence complete 1.0.0 Displayed Markers - sends <displayed/> per v1.0 wire format; <received/> and <acknowledged/> removed per spec; MUC markers use XEP-0359 stanza-id when available complete 1.1.0 HTTP File Upload (XEP-0363) - /upload with snapshot for consistent bytes, ESFS layering (+16 slot for OMEMO channels per XEP-0448), rich SFS emission; also drives async multi-file for /feed embeds partial 0.3.0 OMEMO Encryption using the legacy axolotl namespace (`eu.siacs.conversations.axolotl`) only. OMEMO:2 (`urn:xmpp:omemo:2`) is not published or supported. BTBV (Blind Trust Before Verification) TOFU trust model (UNTRUSTED=0/VERIFIED=1/UNDECIDED=2/BLIND=3 in LMDB `trust:{jid}:{dev}`); only VERIFIED+BLIND receive keys at encode time. PM OMEMO is production-ready; non-anonymous MUC multi-recipient encryption (encode_muc, real-JID occupant mapping, passive bundle prefetch without key-transport spam) is experimental — see docs/planning-muc-omemo.md. Includes auto-detection, per-device bundle/bootstrap, key-transport, MAM plaintext cache for self-decrypt. XEP-0450 ATM removed. complete 1.2.0 PEP Native Bookmarks - modern PEP-based bookmark storage complete 1.3.0 Blocking Command for privacy and spam protection complete 1.6.3 Stream Management: stanza ack/retransmit, session resume with post-connect deferral, resume-failure enable fallback, server preferred reconnect location, handled-count-too-high stream close, graceful disconnect ack complete 1.0.0 The /me Command for IRC-style action messages complete 1.2.0 Direct MUC Invitations - invite users to join chat rooms complete 1.0.0 Client State Indication for mobile optimization complete 0.7.0 Unique and Stable Stanza IDs - stable message identification and deduplication complete 0.4.0 Explicit Message Encryption - advertises encryption method (OMEMO/PGP) on messages complete 0.2.1 Stateless Inline Media Sharing (SIMS) - sends file metadata + sources on upload; parses received SIMS references to display filename, MIME type, size, and download URL; <reference type='data' uri='…'/> extraction (urn:xmpp:reference:0) fixed for proper URL resolution alongside url-data sources complete 0.2.0 File Metadata Element - used inside XEP-0447 file-sharing stanzas with media-type, name, size, hash, width, and height complete 0.3.0 Stateless File Sharing (SFS, XEP-0447) - full stanza builder implementation (src/xmpp/xep-0447.inl) for spec-compliant emission of <file-sharing> + XEP-0446 <file> (media-type/name/size/hash/width/height) + sources on /upload (plain + ESFS); legacy SIMS/OOB for compat; parses incoming too. Used for previews in Conversations etc. partial 0.2.0 Stickers (receive) — detects <sticker xmlns='urn:xmpp:stickers:0'/> with SFS image payloads; displays inline via weechat-icat when xmpp.look.icat is enabled; Movim stickers without <sticker/> are handled via XEP-0231 BoB (see below); sticker pack pubsub not implemented partial 1.1 Bits of Binary — receive: XHTML-IM cid refs and inline <data xmlns='urn:xmpp:bob'/>, IQ-fetch, local cache, weechat-icat display (Movim sticker interop); send: small plaintext images (≤8 KiB) via /upload as BoB + XHTML-IM with sha1 cid hosting and IQ-get responses; advertises urn:xmpp:bob in caps/disco; OMEMO outbound BoB not yet implemented partial 0.1.0 Emoji Markup (receive) — resolves <emoji xmlns='urn:xmpp:markup:emoji:0'/> spans in XEP-0394 markup against sibling SFS/SIMS hashes; displays custom emoji images inline via weechat-icat when xmpp.look.icat is enabled; body fallback text retained complete 1.0.1 Consistent Color Generation - case-sensitive SHA-1 nickname hashing and HSLuv hue mapping to the 216-color terminal cube, with preferred lightness 73.2 and circular hue distance; canonical palette reference vectors tested. Enabled by xmpp.look.consistent_colors; disable to use WeeChat's configured nickname palette. complete 1.1.1 Message Styling - renders *bold*, _italic_, `code`, ~strikethrough~, quotes, and preformatted blocks complete 1.1.0 MUC Self-Ping (Schrödinger's Chat) - verify MUC membership; error conditions correctly classified per §3.2-3.3: service-unavailable/feature-not-implemented/item-not-found treated as still-joined, not-acceptable triggers rejoin partial 0.2.0 Message Fastening - used by Message Moderation (XEP-0425) complete 0.3.0 Message Moderation - allows MUC moderators to retract messages from other users complete 1.0.1 Occupant Identifiers for semi-anonymous MUCs - receive and store occupant-id tag from MUC messages and presences; ignored when room does not advertise urn:xmpp:occupant-id:0 in disco#info (MUST-IGNORE per §4); occupant_id_ line tag used to verify sender identity in XEP-0424 retractions, taking priority over nick matching to handle nick changes partial 2.13.2 Data Forms - reusable interactive editor integrated with Ad-Hoc Commands, MUC room configuration/registration, and account registration (WeeChat 4.3+): core field types, defaults, required-field checks, numbered list choices in server order, multiple values, explicit clearing/omission, hidden-field preservation, and masked private fields without input history. Result forms and reported/item tables are rendered read-only. Manual ad-hoc field=value submission remains available. Extended form validation and media challenges are not implemented. complete 1.3.0 Ad-Hoc Commands (requester role) - /adhoc discovers and executes commands, renders and submits data forms with hidden and multiple values, follows server default actions, and supports next, prev, complete, and cancel. Displays allowed actions, notes, completion, cancellation, and errors; tracks sessions per responder and node. No command responder implementation. partial 1.0 Result Set Management - used internally for MAM paging partial 1.30.0 Publish-Subscribe (PubSub) - passive feed reader receives and renders Atom items from arbitrary PubSub nodes into per-node WeeChat FEED buffers; /feed command fetches items on demand from any service/node pair; retract events trigger re-fetch; /feed subscribe, /feed unsubscribe, /feed subscriptions manage XEP-0060 subscriptions; LMDB deduplication prevents duplicate item display across IQ fetch and push paths; /feed discover lists server pubsub components discovered via XEP-0030 at connect time; /feed (no args) auto-fetches subscriptions from all discovered pubsub services partial 0.2 Order-By for MAM and Pubsub queries (Experimental) - <order xmlns='urn:xmpp:order-by:1' by='creation'/> included in XEP-0442 queries when the service advertises MAM ordering support; ascending order retained for cursor paging. No user-selectable ordering or modification ordering. complete 0.2.0 Pubsub Message Archive Management (client role, Experimental) - discovers service support and queries node archives with explicit query IDs. First restore seeds the latest page; reconnect pages forward from the persisted archive cursor until complete. Checkpoints advance only after a stable complete catch-up; repeated or missing cursors stop paging without advancing. Stale cursors trigger one full archive recovery; other errors fall back to current XEP-0060 items. Atom notifications are deduplicated and rendered with optional forwarded sender attributes supported. Closed feeds and late uncorrelated archive notifications are ignored. partial 0.3.0 Message Markup (Experimental) - receive-only: parses <markup xmlns='urn:xmpp:markup:0'> and applies WeeChat colour codes for <span> (emphasis→italic, strong→bold, code→cyan, deleted→dark-grey), <bcode> (grey monospace block), <bquote> (green prefix per line), and <list>/<li> (bullet markers); when <markup> is present it takes precedence over XEP-0393 ad-hoc styling; urn:xmpp:markup:0 advertised in caps; send side not implemented partial 0.2.2 MUC Mention Notifications (Experimental) - receive side: detects incoming notification messages containing <mentions xmlns='urn:xmpp:mmn:0'> (v0.2.x wire format); §4 MUST source-JID validation: outer from= bare-JID verified to match forwarded message from= bare-JID before processing; renders forwarded groupchat body to MUC buffer with notify_highlight so missed mentions are surfaced even when not present in the room; opt-in publish not yet implemented complete 0.2.0 MAM Preferences (Experimental) - /mam prefs shows current server MAM preferences (default policy, always/never JID lists); /mam prefs default <always|never|roster> sets the default policy; /mam prefs always <jid> and /mam prefs never <jid> add a JID to the respective list; IQ results displayed on the issuing buffer; errors reported with server error type partial 0.1.0 Ephemeral Messages (Experimental) - send: /ephemeral <seconds> <message> sends a message with <ephemeral xmlns='urn:xmpp:ephemeral:0' timer='N'/> and a <no-permanent-store/> hint; receive: <ephemeral> element detected, timer value shown as [⏱ Ns] prefix, weechat_hook_timer scheduled to tombstone the message text after N seconds; urn:xmpp:ephemeral:0 advertised in caps partial 0.2.0 Chat Notification Settings (Experimental) - per-chat preference (always/on-mention/never) stored in XEP-0402 bookmark <extensions><notify xmlns='urn:xmpp:notification-settings:1'>; /notify [jid] [always|on-mention|never] gets or sets preference and re-publishes bookmark; fallback element without identity-category/identity-type used for cross-client interop partial 0.3.0 Encrypted File Sharing (XEP-0448) - when /upload to OMEMO channel: AES-256-GCM encrypt snapshot before PUT (slot +16), visible body=aesgcm://...#ivkey, stanza uses builder-generated <file-sharing><sources><encrypted cipher=...><key b64/><iv b64/><hash cipher/><sources><url-data https-for-cipher/></sources></encrypted></sources></file-sharing> (plain <file> metadata always); receive side parses <encrypted> for download/decrypt in background. Builder ensures exact nesting per spec examples. (Status upgraded with proper emission support.) partial 0.1.0 OMEMO Media sharing — receive path parses strict aesgcm:// body URLs (converse.js and similar) into ESFS download/decrypt + LMDB cache and icat preview for images; send path already emits aesgcm:// visible links for OMEMO uploads. partial 0.6.5 Microblogging over XMPP (Deferred) - /feed post publishes Atom entries to urn:xmpp:microblog:0 PEP node; /feed reply adds thr:in-reply-to threading with real Atom entry IRI in @ref (RFC 4685); /feed repeat publishes boost entry with <link rel='via'> (XEP-0472 §4.5); /feed retract retracts items; /feed comments fetches the comments/replies node linked via <link rel='replies'>; incoming PEP microblog push events rendered with full Atom metadata: author URI, updated timestamp, categories, enclosures, geolocation (XEP-0080), replies links; XHTML and HTML content rendered with WeeChat formatting; plain-text content rendered with lightweight Markdown-to-WeeChat formatting; feed-level <feed> metadata items update buffer title; deduplication via LMDB; urn:xmpp:microblog:0+notify advertised in caps partial 0.2.1 Pubsub Social Feed (Experimental) - /feed post sets pubsub#type=urn:xmpp:microblog:0 and required publish-options (persist_items, max_items=max, notify_retract, deliver_payloads=false); --open flag sets pubsub#access_model=open; <generator> element included in published entries; urn:xmpp:pubsub-social-feed:1 advertised in disco#info; Atom entry parsing: author name+URI, title, summary, content (text/xhtml/html), published+updated timestamps, categories, enclosures, geolocation, <link rel='replies'> comments links; thr:in-reply-to@ref uses real Atom entry IRI when cached; feed-level <feed> metadata items recognised and displayed; XHTML rendered via XEP-0071 renderer; HTML tag-stripped to plain text; plain-text content rendered with lightweight Markdown-to-WeeChat formatting (headings, bold, italic, inline code, fenced code blocks, blockquotes, lists, links, images, strikethrough, horizontal rules); publish errors reported in buffer partial 1.5.4 XHTML-IM - receives and renders rich text: bold, italic, underline, code, blockquotes, links, CSS color spans partial 1.1.1 vCard-Based Avatars - receives presence photo hashes and fetches roster contacts' vCards; emits the cached own avatar hash in presence and advertises support in caps. /setavatar publishes via XEP-0084 only; no vCard PHOTO publishing or full synchronization between the two avatar protocols. complete 1.0 Attention - receives attention requests and opens a PM buffer; advertised in caps partial 0.2.0 Moved - displays unverified migration notices from incoming subscription requests; PEP verification, automatic roster migration, and publishing an own-account migration are not implemented partial 1.0 Forwarded Messages - used as wrapper for Message Carbons and MAM results partial 1.0.0 Cryptographic Hash Functions - SHA-256 used in SIMS (XEP-0385) file metadata complete 1.0.0 Message Processing Hints - store/no-store/no-copy applied to transient stanzas (typing, reactions, link previews) partial 0.5.0 References - incoming mention references targeting the local JID trigger highlights; data references are used for SIMS media sharing. Outgoing mention references and general reference editing are not implemented. complete 0.2.0 Spoiler Messages - displays spoiler warning prefix when a message contains a spoiler hint complete 0.4.2 Message Retraction - /retract command with tombstone display and MAM cache update complete 0.2.1 Fallback Indication - sent alongside retraction and reply stanzas; reply fallback [start,end) Unicode code-point ranges are converted to UTF-8 byte offsets for trimming on receive complete 0.2.1 Message Reactions - /react command; reactions appended to original message line; empty <reactions> removes reaction display per §3.2 complete 0.2.1 Message Replies - /reply command with quoted excerpt displayed on receive complete 1.0.1 Message Displayed Synchronization - publishes MDS PEP item when messages are read (on send, type, and buffer switch); consumes MDS events from other own devices to sync read state complete 0.1.1 Link Metadata - fetches and sends OpenGraph previews for outgoing URLs; renders incoming rdf:Description previews with title, description, URL, and image indicator partial 0.1.0 Extended Channel Search (Searcher role) - /list command queries any XEP-0433-capable search service (default: search.jabber.network) and displays results with name, address, user count and description; advertises urn:xmpp:channel-search:0:search in disco#info partial 0.1.0 Room Activity Indicators — client subscribes by sending presence with <rai xmlns='urn:xmpp:rai:0'/> to own bare JID on connect; displays incoming <activity> notifications in the account buffer; advertises urn:xmpp:rai:0 in disco#info partial 2.4 In-Band Registration — §3.1 /account register <name> <jid> <password>: new account registration before authentication over verified STARTTLS; supports username/password flat fields, already-registered detection, OOB-redirect, and interactive x:data forms on WeeChat 4.3+. Forms take precedence over flat fields, preserve hidden values, mask passwords, and retain answers after rejection; accounts are added only after server acknowledgement. CAPTCHA/media challenges are unsupported and direct users to web registration. §3.2 /account unregister <account>: cancels the account on the server while authenticated. §3.3 /account password <account> <new-password>: in-band password change while authenticated (TLS required). §10: advertises jabber:iq:register in disco#info. 1.1.1 2026-10-29 Package builds stay on Clang when RPM or Alpine export g++. SASL ANONYMOUS login via /account add --anon (XEP-0175); the server assigns a temporary JID. 1.1.0 2026-10-29 Displayed markers wait until the buffer is viewed, with a dwell delay. Live PMs and carbons stay ordered after archive catchup. Offline PM delivery waits until chat history finishes. Nix package (flake.nix). 1.0.0 2026-10-09 Requires WeeChat 4.3 or newer and C++23. Interactive ad-hoc, MUC configuration/registration, and account registration forms; verified STARTTLS for account registration; MAM replay/checkpoint and PubSub archive fixes; legacy OMEMO device/key handling fixes; vCard preservation and publication acknowledgement. 0.12.0 2026-07-24 Safe plugin unload/reload and atomic installation; OMEMO multi-client and MUC bootstrap fixes; /omemo prune; upload path handling and picker/preview improvements; faster debug builds. 0.11.0 2026-07-06 /disco summary server capability matrix (manual + auto-print to account log after connect); connect probes gated on server disco#info (SM, CSI, MAM, bookmarks, MDS only when advertised); MUC OMEMO experimental status documented. Post-tag fixes on master: FreeBSD build (libdiff jobserver, strophe includes), /disco summary output on BSD, OMEMO libsignal session log sanitization for MUC decrypt. 0.9.0 2026-06-10 XEP-0449 sticker and XEP-0514 custom emoji inline display via weechat-icat; XEP-0231 BoB receive (inline data and XHTML-IM cid IQ-fetch) for Movim stickers; outgoing emoticon-to-emoji conversion on the wire (xmpp.look.emoticons). BoB send/hosting added post-release on master. 0.7.0 2026-06-03 Fix upload-disconnect bug (unsafe OpenSSL BIO base64 replaced with weechat_string_base_encode, gmtime_r for thread safety, dangling shared_ptr fix); BTBV trust commands (/omemo trust, /omemo distrust with optional device-id, trust levels in /omemo devices); remove stale ATM/XEP-0450 code; XEP-0437 Room Activity Indicators (subscribe on connect, display activity notifications) 0.6.0 2026-03-31 Embed tags for /feed post: {{ embed }}, {{ attach }}, {{ video }} upload files via XEP-0363 and publish XEP-0447 <file-sharing> children in Atom entries; async multi-file upload pipeline with draft-save on failure; SFS summary rendering in feed and message buffers; comment Atom structure fix (body in <title>, no <content>, per XEP-0277 §3.2); feed_compose.py context-aware editor suppresses title frontmatter when run from a comments buffer 0.5.0 2026-03-24 Bug fixes: XEP-0511 outgoing link preview double-send and missing <body/> element; <title> fallback for pages without OpenGraph metadata; MAM PM queries now correctly addressed to own bare JID instead of bare server domain; first-build no longer requires a pre-existing .depend file 0.4.0 2026-03-09 Outgoing link previews (XEP-0511 send), Ad-Hoc Commands (XEP-0050), Data Forms (XEP-0004), XHTML-IM (XEP-0071), References (XEP-0372), Message Displayed Synchronization (XEP-0490), Message Fastening (XEP-0422), Fallback Indication (XEP-0428), Spoiler Messages (XEP-0382), Attention (XEP-0224), Moved (XEP-0283), Consistent Color Generation (XEP-0392), Extended Channel Search (XEP-0433), MUC /kick /ban /topic /nick commands (XEP-0045), XEP-0198 stanza retransmit queue, non-blocking HTTP upload (XEP-0363), own nickname publishing (XEP-0172), MDS read flush on buffer switch (XEP-0490), In-Band Registration (XEP-0077), and further bug fixes