shithub: xmpp

ref: ed2752fe715680692023bbcaf85ddf03c2444c2c
dir: /README/

View raw version
XMPP(1)                     General Commands Manual                    XMPP(1)



NAME
       xmpp - XMPP client

SYNOPSIS
       xmpp [ -n nick ] [ -r resource ] [ -p ] [ -h ] [ -y ] jid | jid@server

DESCRIPTION
       xmpp is a simple XMPP client.

       It supports multi-user chat (MUC).  Server-side bookmarks are used to
       join specific MUCs automatically on connect. TLS is required, SCRAM-
       SHA-1, DIGEST-MD5 and PLAIN authentication methods are supported.  The
       latter is enabled using -y option. Thumbprints of trusted servers are
       expected to be in /sys/lib/tls/xmpp, see thumbprint(6).

       -p enables "joined"/"left" messages, which are disabled by default.

       -h allows MUCs to send out "discussion history".

       The command language understood by xmpp is as follows:
       /j [jid[/nick] [passwd]]
             join MUC
       /p [target]
             part MUC
       /q data
             send raw data to the server
       /t target
             cycle through matching targets
       /w [target]
             get list of active nicks in the MUC
       /W [target]
             get list of all nicks in the MUC
       /b
             list bookmarked MUCs
       /b+
             bookmark current MUC
       /b-
             remove current MUC from bookmarks
       /a target affiliation
             set affiliation (for a target in MUC)
       /a [room]
             get affiliations for a room (current one if no args given)
       /me ...
             "/me"-style message
       /m
             start multiline message (end with a dot on a single line)
       /n nick
             set nick for current MUC
       /r
             show roster (list online contacts)
       /R
             show roster (show offline and jids)
       /r+ (jid|target) [name]
             subscribe/approve, add to roster
       /r- target
             unsubscribe/decline, remove from roster
       /s [room]
             show current subject
       /S [room]
             start new subject (end with a dot on a single line)

       Affiliations are: none, owner, admin, member, outcast.

       The target can be specified as follows:
       room@domain            a specific room
       room@domain/nick       private chat (MUC)
       Wernher                private chat (roster, name)
       wernher@paperclip.gov  private chat (roster, jid)

       Assuming you previously joined a MUC pravda@cc.cpsu.su, you can quickly
       switch to private chat with kgbvax as follows:
       /t pravda/kgbvax
       /t pr/kgb
       /t p/k

SOURCE
       https://git.sr.ht/~ft/xmpp

BUGS
       Of course.

NOTES
       XMPP sucks. XML sucks.



                                                                       XMPP(1)