https://github.com/SkaveRat/xmpptrix

Matrix XMPP Bridge
https://github.com/SkaveRat/xmpptrix

Last synced: 5 days 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 (about 9 years ago)
• Last Synced: 2024-08-01T12:34:46.438Z (3 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`