sendxmppp - Online in the Cloud

PROGRAM:

NAME

sendxmpp - send xmpp messages from the commandline.

SYNOPSIS

sendxmpp [options] <recipient1> [<recipient2> ...]

sendxmpp --raw [options]

DESCRIPTION

sendxmpp is a program to send XMPP (Jabber) messages from the commandline, not unlike
mail(1). Messages can be sent both to individual recipients and chatrooms.

OPTIONS

-f,--file file
Use file configuration file instead of ~/.sendxmpprc

-u,--username user
Use user instead of the one in the configuration file

-p,--password password
Use password instead of the one in the configuration file

-j,--jserver server
Use jabber server instead of the one in the configuration file.

-o,--component componentname
Use componentname in connect call. Seems needed for Google talk.

-r,--resource res
Use resource res for the sender [default: 'sendxmpp']; when sending to a chatroom,
this determines the 'alias'

-t,--tls
Connect securely, using TLS

-e,--ssl
Connect securely, using SSL

-n,--no-tls-verify
Deactivate the verification of SSL certificates. Better way is to use parameter
--tls-ca-path with the needed path to CA certificates.

-a,--tls-ca-path
Path to your custom CA certificates, so you can verificate SSL certificates during
connecting.

-l,--headline
Backward compatibility option. You should use --message-type=headline instead. Send a
headline type message (not stored in offline messages)

--messages-type
Set type of message. Supported types are: message chat headline. Default message type
is message. Headline type message can be set also with --headline option, see
--headline

-c,--chatroom
Send the message to a chatroom

-s,--subject subject
Set the subject for the message to subject [default: '']; when sending to a chatroom,
this will set the subject for the chatroom

-m,--message message
Read the message from message (a file) instead of stdin

-i,--interactive
Work in interactive mode, reading lines from stdin and sending the one-at-time

-w,--raw
Send raw XML message to jabber server

-v,--verbose
Give verbose output about what is happening

-h,--help,--usage
Show a 'Usage' message

-d,--debug
Show debugging info while running. WARNING: This will include passwords etc. so be
careful with the output!

CONFIGURATION FILE

You may define a '~/.sendxmpprc' file with the necessary data for your xmpp-account, with
a line of the format:

user@server password componentname

e.g.:

# my account
alice@jabber.org secret

('#' and newlines are allowed like in shellscripts). You can add a host (or IP address) if
it is different from the server part of your JID:

# account with specific connection host
alice@myjabberserver.com;foo.com secret

You can also add a port if it is not the standard XMPP port:

# account with weird port number
alice@myjabberserver.com:1234 secret

Of course, you may also mix the two:

# account with a specific host and port
alice@myjabberserver.com;foo.com:1234 secret

NOTE: for your security, sendxmpp demands that the configuration file is owned by you and
readable only to you (permissions 600).

EXAMPLE

$ echo "hello bob!" | sendxmpp -s hello someone@jabber.org

or to send to a chatroom:

$ echo "Dinner Time" | sendxmpp -r TheCook --chatroom test2@conference.jabber.org

or to send your system logs somewhere, as new lines appear:

$ tail -f /var/log/syslog | sendxmpp -i sysadmin@myjabberserver.com

NOTE: be careful not the overload public jabber services

Use sendxmppp online using onworks.net services