sendxmpp

sendxmpp is a perl-script to send xmpp (jabber), similar to what mail(1) does for mail.

sendxmpp was written by Dirk-Jan C. Binnema, and is available under the term of the GNU General Public License v2. The hard work is done by Ryan Eatmon's Net::XMPP-modules, and you need to have them installed for sendxmpp to work. Current package maintainer is Lubomir Host <lubomir.host@gmail.com>

Obviously, you also need a jabber account; they are freely available at jabber.org, but you can also run your own server.

sendxmpp is in use on computers around the globe, for example for distributing CVS-commit alerts, sending server warnings and notifying users. If you use sendxmpp in some other creative way, please drop me a mail at <lubomir.host@gmail.com> or IM me at lhost@jabber.org. Thanks!

News

2014-09-13:
- released version 1.24, see sendxmpp git tags for other versions
- new config file format, see my blog for example
2012-10-28:
- released version 1.23, see sendxmpp git tags for other versions
- added options --no-tls-verify and --tls-ca-path, thanks to Alexander Weidinger <aw AT sz9i.net>
2012-10-20:
2008-08-25:
- Fix: fixed parsing of account with specific connection host Thanks to Klaus Alexander Seistrup <klaus AT seistrup.dk>
2007-09-10:
- Fix: config file permission check did not allow read only file (Andrej Mikus)
- Fix: authentication to Google Talk server (Andrej Mikus)
- Feature: added a -l/--headline option to sendxmpp, to allow to send a headline type message (Jerome Sautret)
2007-03-25: Fix: groupchat message doesn't has subject attribute. Thanks to Jakub Tucek <public AT otaznik.net>
2006-10-17: Added support for raw XML messages. Documentation enhancement. Thanks to David Ammouial <da AT weeno.net>
2006-10-04: CVS repository of sendxmpp has been established and a lot of bugs fixed.
2006-09-25: package maintainer changed. New package maintainer is Lubomir Host <lubomir.host@gmail.com>
2005-05-07: sendxmpp version 0.0.8 has been released. This version brings some documentation improvements and also you specify non-default port numbers for jabber servers.
2005-05-02: sendxmpp is still alive :-) and there is now version 0.0.7, which brings some fixes to the documentation, and a new --interactive mode, which will read lines from stdin and send them line-by-line (idea from Sün). It's still experimental and I don't think '--interactive' is a good name, but at least you can try now... Please report any problems. UPDATE: fix for typo; version 0.0.7.1 (thanks to Daniel Eckl)
2004-12-09: some jabber servers don't work with sendxmpp; it seems there's a problem in one of the underlying libraries (Net::XMPP and XML::Stream), and sendxmpp will end with an error, similar to:
```
					Can't use an undefined value as a HASH reference at /usr/lib/perl5/site_perl/5.8.4/XML/Stream.pm line 1165.
			
```
I've notified their author, and he's working on a solution. jabber.org should work though, jabber.xs4all.nl doesn't.
2004-12-07: version 0.0.6 is released; there is a small fix for the installation paths. With perl Makefile.PL both manpage and script will be installed under /usr/local, and perl Makefile.PL PREFIX=/usr will install everything under /usr. The should solve the problem of not being able to find the manpage.
2004-12-01: version 0.0.5 is released.
- Allow non-\w characters in passwords
- Set the subject for chatroom messages
- Documentation updates (both code and user docs)
2004-11-20: version 0.0.4 is released. New stuff:
- Some minor little thingies
- Uses the perl Makefile stuff now , i.e., you must do:
```
	$ perl Makefile.PL
	$ make
	$ make install
	
```
- This will also generate the documentation as a industry-standard, enterprise-ready, etc. etc. man page
2004-11-17: version 0.0.3 is released. New features are:
- Support for authentication using SSL/TLS;
- Support for sending messages to chatrooms;
- Support for providing login information on the command line;
- Improved error handling;
- NOTE: the .sendxmpprc format has changed.

Example

Suppose you have to manage a remote server somewhere, and you have to keep an eye on its cpu load-average. You could write a script to check this, and run it periodically from cron. This script could contain something like:

if test "$cpuload" -gt "$CPULOADMAX"; then
  top -b -n 1 | sendxmpp -s "wake up! cpu load $cpuload at `hostname`" someone@jabber.org  
fi

And on my client machine, my jabber-client wil pop-up a message, depending on your client. There are many different client, for any platform/OS.

This is just a small example; many more interesting things become really easy now. Use it from your .procmailrc. Or your logwatcher scripts. Or... (Mail is *so* 20th century :-)

More information

Try sendxmpp -h.

Download and installation

From Git repository

Git repository of sendxmmp is located on github.com

        cd /tmp
        git clone https://github.com/lhost/sendxmpp.git
        cd sendxmpp/
        perl Makefile.PL;  # perl Makefile.PL PREFIX=/usr
        make
        make install

From the tarball

You can download sendxmpp here: sendxmpp-1.23.tar.gz. Installation is simple (for step 4 you may need root-privs):

unpack the tarball, and enter the new directory

$ perl Makefile.PL
$ make
$ make install

NOTE1: this will install under /usr/local/. If you want to install somewhere else you could do (step 2): perl Makefile.PL PREFIX=/usr.
NOTE2: for older versions, just change the version number in the URL.

Contact

Previous package maintainer was Dirk-Jan C. Binnema <djcb AT djcbsoftware.nl>.
Since 2006-09-25 package maintainer is Lubomir Host <lubomir.host@gmail.com>.