search

matrix-hacks / matrix-puppet-slack

puppet style slack bridge for matrix
47 stars 17 forks source link
bridge matrix slack

readme

matrix-puppet-slack #matrix-puppet-bridge:matrix.org

This is an unofficial matrix slack bridge that works by means of user puppetting.

Get your user_access_token from here:

https://api.slack.com/docs/oauth-test-tokens

The bridge uses that access token to connect as a client using the slack RTM API.

This technique does not require admin on the slack team; instead, the bridge is simply a custom slack client.

The bridge supports multiple teams at once, see the config.sample.json

installation

clone this repo

cd into the directory

run npm install

configure

Copy config.sample.json to config.json and update it to match your setup. Add as many teams as you like by adding them to the array.

If you are running another bridge that uses the default slack prefix, change the prefix now. You cannot change this value after the bridge has created rooms and ghost users.

register the app service

Generate an slack-registration.yaml file with node index.js -r -u "http://your-bridge-server:8090"

Note: The 'registration' setting in the config.json needs to set to the path of this file. By default, it already is.

Copy this slack-registration.yaml file to your home server. Make sure that from the perspective of the homeserver, the url is correctly pointing to your bridge server. e.g. url: 'http://your-bridge-server.example.org:8090' and is reachable.

Edit your homeserver.yaml file and update the app_service_config_files with the path to the slack-registration.yaml file.

Launch the bridge with node index.js.

Restart your HS.

docker

Build the docker image with docker build -t matrix-puppet-slack ..

Copy config.sample.json to config.json and update it to match your setup. You can work in any directory you want as you have the docker image now. Set the registrationPath in the config.json to /data/slack-registration.yaml.

Generate the slack-registration.yaml file in the data volume with docker run --rm -it -v `pwd`/data:/data -v `pwd`/config.json:/usr/src/app/config.json matrix-puppet-slack node index.js -r -u "http://your-bridge-server:8090".

As discribed in register the app service copy the registration file to your homeserver and add it to your homeserver.yaml file.

Launch the bridge with docker run -v `pwd`/data:/data -v `pwd`/config.json:/usr/src/app/config.json matrix-puppet-slack or via docker-compose.

Discussion, Help and Support

Join us in the Matrix Puppet Bridge room

Features and Roadmap