Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SkaveRat/xmpptrix
Matrix XMPP Bridge
https://github.com/SkaveRat/xmpptrix
Last synced: about 1 month ago
JSON representation
Matrix XMPP Bridge
- Host: GitHub
- URL: https://github.com/SkaveRat/xmpptrix
- Owner: SkaveRat
- License: gpl-2.0
- Created: 2015-07-04T01:12:55.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2015-08-28T10:51:15.000Z (over 9 years ago)
- Last Synced: 2024-08-01T12:34:46.438Z (4 months ago)
- Language: JavaScript
- Size: 207 KB
- Stars: 32
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starred - SkaveRat/xmpptrix - Matrix XMPP Bridge (others)
README
# xmpptrix - Matrix.org XMPP Bridge
A WIP xmpp bridge for matrix.org
## TODO
* Presence change
* Better errorhandling
* More logging
* Set powerlevel for user to op, so room name can be properly changed
* handle leaving the room (re-invite on new message)
* handle adding user to roster (adding @xmpp_* prefixed user)
* MUC## Setup
### Create application server config
create a yml config:
```yml
#the base URL of the application service
url: "http://localhost:61444"# This is the token that the AS should use as its access_token when using the Client-Server API
# This can be anything you want.
as_token: mysecret# This is the token that the HS will use when sending requests to the AS.
# This can be anything you want.
hs_token: myothersecret# this is the local part of the desired user ID for this AS (in this case @logging:localhost)
sender_localpart: xmppbridge
namespaces:
users:
- exclusive: true
regex: "@xmpp_.*"
rooms: []
aliases: []
```### Add the application server config to the homeserver.yaml
add path to the application server config to the `app_service_config_files` array:
```yml
app_service_config_files:
- "/path/to/config.yml"```
### Running the setup and adding an account
Install dependencies with `npm install`.
First run `setup.js`, after that run `create_account` to add an xmpp account.
Run the bridge with `node index.js`. You will get an invide for every contact in your roster. This might take a few seconds.
## Logs
Logs are handles with bunyan. Per default, it logs everything as json.
Stdout will only output INFO levels. There are ERROR and DEBUG logs in the `logs` directory.
To make the output human readable, you can pipe the output into the bunyan CLI tool:
`tail -f log/* | node_modules/bunyan/bin/bunyan`