https://github.com/majewsky/xmpp-bridge
Connect command-line programs to XMPP
https://github.com/majewsky/xmpp-bridge
Last synced: 5 days ago
JSON representation
Connect command-line programs to XMPP
- Host: GitHub
- URL: https://github.com/majewsky/xmpp-bridge
- Owner: majewsky
- License: gpl-3.0
- Created: 2016-08-25T20:25:57.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2017-05-22T20:19:44.000Z (about 8 years ago)
- Last Synced: 2025-04-14T16:00:24.447Z (2 months ago)
- Language: C
- Homepage:
- Size: 50.8 KB
- Stars: 10
- Watchers: 5
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# xmpp-bridge
A simple program that connects to an XMPP account and communicates with a
specified peer. Text is read from stdin and sent to the peer, and any messages
received from the peer will be printed on stdout.
The intended usage is as a building-block for other programs (or shell scripts)
that want to communicate status information over XMPP, or wish to ask for
input over XMPP.
## Installation
[libstrophe](https://github.com/strophe/libstrophe) is required. Build with
```bash
make
make install
```
As a developer, say `make MODE=debug` instead.
## Usage
Set the environment variables `XMPPBRIDGE_JID`, `XMPPBRIDGE_PASSWORD` and `XMPPBRIDGE_PEER_JID` to the respective
values, then call `xmpp-bridge`.
A common usecase is to prepend `xmpp-bridge` to a cron job's command line, so
that its stdin and stdout are connected to XMPP.
```bash
$ cat test.sh
echo "What's your name?"
read ANSWER
echo "Hi ${ANSWER}!"
$ xmpp-bridge bash test.sh
```
For details (e.g. option arguments), have a look at the [manpage](./xmpp-bridge.1).