NAME

       go-sendxmpp - A little tool to send messages to an XMPP contact or MUC.

SYNOPSIS

       go-sendxmpp  [-cdintx] [-f value] [--help] [-j value] [-m value] [-p value] [-r value] [-u
       value] [parameters ...]

DESCRIPTION

       A little tool to send messages to an XMPP contact or MUC inspired by (but not as  powerful
       as) sendxmpp.
       You  can either pipe a programs output to go-sendxmpp, write in your terminal (put ^D in a
       new line to finish) or send the input from a file (-m or --message). The account  data  is
       expected  at  ~/.config/go-sendxmpp/config  (preferred),  ~/.config/go-sendxmpp/sendxmpprc
       (deprecated) ~/.sendxmpprc (for compatibility with the original perl sendxmpp) if no other
       configuration file location is specified with -f or --file.

OPTIONS

       -c, --chatroom=[value]: Send message to a chatroom.

       -d, --debug: Show debugging info.

       -f, --file=[value]: Set configuration file. (Default: ~/.config/go-sendxmpp/config)

       --help: Show help.

       --http-upload=[value]: Send a file via http-upload.

       -i, --interactive: Interactive mode (for use with e.g. tail -f).

       -j, --jserver=[value]: XMPP server address.

       -l,  --listen:  Listen  for  messages and print them to stdout. If JIDs are specified only
       messages from those contacts are shown. If no JIDs are  specified  all  received  messages
       will be shown.

       -m, --message=[value]: Set file including the message.

       --muc-password=[value]: Password for password protected MUCs.

       -n, --no-tls-verify: Skip verification of TLS certificates (not recommended).

       --ox: Use "OpenPGP for XMPP" encryption (experimental).
       Ox  in go-sendxmpp only supports sending encrypted 1-1 messages. Sending to groupchats and
       sending encrypted files is not supported. There is no check whether the recipients key  is
       trusted  as there is no local keyring used. Go-sendxmpp just uses the most recent key that
       is provided via pubsub and checks that it is not expired.

       --ox-delete-nodes: Delete existing OpenPGP nodes on the server.

       --ox-genprivkey-rsa: Generate a private OpenPGP key (RSA  4096  bit)  for  the  configured
       account  (via  config  file  or  -u  and  -p)  and  publish  the corresponding public key.
       Go-sendxmpp   will   save   the   key    in    $XDG_DATA_HOME/go-sendxmpp/oxprivkeys    or
       $HOME/.local/share/go-sendxmpp/oxprivkeys.  To  protect  the key a passphrase might be set
       using --ox-passphrase while generating the key.
       If there is an existing private key for "OpenPGP for XMPP" created by another client (e.g.
       profanity) it might be imported using --ox-import-privkey.

       --ox-genprivkey-x25519: Generate a private OpenPGP key (X25519) for the configured account
       (via config file or -u and -p) and publish the corresponding public key. Go-sendxmpp  will
       save        the        key        in        $XDG_DATA_HOME/go-sendxmpp/oxprivkeys       or
       $HOME/.local/share/go-sendxmpp/oxprivkeys. To protect the key a passphrase  might  be  set
       using --ox-passphrase while generating the key.
       If there is an existing private key for "OpenPGP for XMPP" created by another client (e.g.
       profanity) it might be imported using --ox-import-privkey.

       --ox-import-privkey=[value]: Import an existing private OpenPGP key.

       --ox-passphrase=[value]: Passphrase for locking and unlocking the private OpenPGP key.

       --tls-version=[value]: Minimal TLS version. 10 (TLSv1.0), 11 (TLSv1.1), 12  (TLSv1.2),  13
       (TLSv1.3) (Default: 12)

       -p, --password=[value]: Password for XMPP account.

       --raw:  Send  raw XML. To send raw XML to a contact as normal chat message no contact must
       be specified. To send raw XML to a MUC you have to specify the MUC via -c and  go-sendxmpp
       will join the MUC.

       -r, --resource=[value]: Set resource. When sending to a chatroom this is used as 'alias'.

       --timeout=[value]: Connection timeout in seconds. (Default: 10)

       -t, --tls: Use direct TLS.

       -u, --username=[value]: Username for XMPP account (JID).

       --version: Show version information.

CHAT

       Feel free to join https://join.jabber.network/#go-sendxmpp@chat.mdosch.de?join.

AUTHOR

       Written by Martin Dosch.

REPORTING BUGS

       Report bugs at https://salsa.debian.org/mdosch/go-sendxmpp/issues.

COPYRIGHT

       Copyright (c) 2018 - 2021 Martin Dosch License: BSD 2-clause License

SEE ALSO

       go-sendxmpp(5), sendxmpp(1)

                                             May 2022                              GO-SENDXMPP(1)