mirror of https://salsa.debian.org/mdosch/go-sendxmpp synced 2024-11-12 13:10:25 +00:00

Go to file

Tyler 7696a9eb09 Allow 640 permissions Fixes #1		2020-06-24 20:44:17 +00:00
man	Clarify that username should be a JID in the manpages too.	2020-06-06 12:42:19 +02:00
vendor	Updated vendored dependency go-xmpp	2020-03-25 00:34:16 +01:00
.gitignore	Initial commit	2018-08-04 12:16:28 +02:00
go-sendxmpp.go	Allow 640 permissions	2020-06-24 20:44:17 +00:00
go.mod	Move repo from mdosch-guest to mdosch	2020-04-23 09:11:37 +02:00
go.sum	Updated vendored dependency go-xmpp	2020-03-25 00:34:16 +01:00
httpupload.go	Check for http status code.	2020-04-11 16:08:15 +02:00
jid.go	Fix typos	2020-04-05 22:02:09 +02:00
LICENSE	Fix whitespaces in licenses.	2020-04-04 14:20:03 +02:00
LICENSE-mellium	Fix whitespaces in licenses.	2020-04-04 14:20:03 +02:00
README.md	Clarify that the username should be a JID.	2020-06-06 12:06:09 +02:00

README.md

go-sendxmpp

about

A little tool to send messages to an XMPP contact or MUC inspired by sendxmpp.

requirements

installation

If you have GOPATH set just run this commands:

$ go get salsa.debian.org/mdosch/go-sendxmpp
$ go install salsa.debian.org/mdosch/go-sendxmpp

You will find the binary in $GOPATH/bin or, if set, $GOBIN.

usage

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 ~/.sendxmpprc if no other configuration file location is specified with -f or --file. The configuration file is expected to be in the following format:

username: <your_jid>
jserver: <jabber_server>
port: <jabber_port>
password: <your_jabber_password>

If no configuration file is present or if the values should be overridden it is possible to define the account details via command line options:

 Usage: go-sendxmpp [-cdintx] [-f value] [--help] [--http-upload value] [-j value] [-m value] [-p value] [-r value] [-u value] [parameters ...]
 -c, --chatroom     Send message to a chatroom.
 -d, --debug        Show debugging info.
 -f, --file=value   Set configuration file. (Default: ~/.sendxmpprc)
     --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.
 -m, --message=value
                    Set file including the message.
 -n, --no-tls-verify
                    Skip verification of TLS certificates (not recommended).
 -p, --password=value
                    Password for XMPP account.
 -r, --resource=value
                    Set resource. When sending to a chatroom this is used as
                    'alias'. (Default: go-sendxmpp) [go-sendxmpp]
 -t, --tls          Use TLS.
 -u, --username=value
                    Username for XMPP account (JID).
 -x, --start-tls    Use StartTLS.

examples

Send a message to two recipients using a configuration file.

cat message.txt | ./go-sendxmpp -f ./sendxmpp recipient1@example.com recipient2@example.com

Send a message to two recipients directly defining account credentials.

cat message.txt | ./go-sendxmpp -u bob@example.com -j example.com -p swordfish recipient1@example.com recipient2@example.com

Send a message to two groupchats (-c) using a configuration file.

cat message.txt | ./go-sendxmpp -cf ./sendxmpp chat1@conference.example.com chat2@conference.example.com

Send file changes to two groupchats (-c) using a configuration file.

tail -f example.log | ./go-sendxmpp -cif ./sendxmpp chat1@conference.example.com chat2@conference.example.com