An easy to set-up simple pupetting bridge for talking to all your IM contacts through Matrix
Go to file
Alex 0d54b5acdb Colors 2020-03-01 20:41:18 +01:00
connector Messenger: hopefully handle joins correctly 2020-03-01 20:38:00 +01:00
external Messenger: hopefully handle joins correctly 2020-03-01 20:38:00 +01:00
mxlib Allow _ezbr_ to be put in suffix of usernames/room aliases instead of prefix 2020-02-29 10:51:09 +01:00
static/css Stub web interface 2020-02-26 17:45:25 +01:00
templates Colors 2020-03-01 20:41:18 +01:00
test Logging; fix xmpp a bit 2020-02-17 09:41:08 +01:00
.gitignore Some infrastructure 2020-02-16 19:30:49 +01:00
Dockerfile Put Easybridge avatar in Docker container 2020-02-28 20:07:47 +01:00
LICENSE Add Dockerfile, LICENSE, README.md 2020-02-28 19:14:04 +01:00
Makefile Support for external processes; stub FB messenger bridge 2020-02-29 18:34:14 +01:00
README.md Allow _ezbr_ to be put in suffix of usernames/room aliases instead of prefix 2020-02-29 10:51:09 +01:00
account.go Now receiving messages from messenger as well (rudimentary) 2020-03-01 14:14:18 +01:00
db.go Allow _ezbr_ to be put in suffix of usernames/room aliases instead of prefix 2020-02-29 10:51:09 +01:00
easybridge.jpg Refactor: move all mx* functions to mxlib/client.go 2020-02-21 14:27:42 +01:00
go.mod Add LRU cache for some DB operations 2020-02-28 11:06:43 +01:00
go.sum Implement account configuration save/load from db 2020-02-26 20:21:32 +01:00
main.go Now receiving messages from messenger as well (rudimentary) 2020-03-01 14:14:18 +01:00
server.go Support for external processes; stub FB messenger bridge 2020-02-29 18:34:14 +01:00
util.go Allow _ezbr_ to be put in suffix of usernames/room aliases instead of prefix 2020-02-29 10:51:09 +01:00
web.go Error channels; notify users of restart 2020-02-28 17:42:15 +01:00

README.md

Easybridge

Easybridge is a Matrix-to-everything (almost) bridge. It acts as a client under your name on all instant messaging networks where you have an account, and presents your private messages as well as group conversations in Matrix in a uniform view. Basically, Matrix becomes your everything chat client!

Current features:

  • Backends: IRC, XMPP, Mattermost (more to come)
  • Private messages and group/chat room messages
  • Automatic setup of Matrix rooms that bridge to outside rooms
  • Room name and topic synchronization (partially)
  • Images and file transfers (Mattermost backend)
  • Avatar and room pictures (Mattermost backend, one-way only)
  • Web interface for setting up accounts so that new accounts can be easily added and you don't have to type your credentials in a clear-text Matrix room
  • Credentials are stored encrypted in the database using users' Matrix passwords

There is lot to do! See the issues if you want to join us on this project.

A Docker image is provided on the Docker hub.

Easybridge takes a single command line argument, -config <filename>, which is the path to its config file (defaults to ./config.json). The configuration file is a JSON file whose contents is described in the following section.

Easybridge is licensed under the terms of the GPLv3.

Building Easybridge

Easybridge requires go 1.13 or later.

To build Easybridge, clone this repository outside of your $GOPATH. Then, run make in the root of the repo.

Configuring Easybridge

Easybridge acts as a Matrix application service: in this regard, it requires a registration file to be added to your homeserver. It uses a database to store configuration and state information, which can be any backend supported by Gorm.

Easybridge is configured using a single JSON configuration file, which contains a dictionnary whose keys are the following:

  • log_level: what log level Easybridge runs with (trace, debug, info, warn, error, fatal, panic). Warning: in trace level, the content of all calls to the Matrix API and some other information will be dumped, exposing user's credentials and messages. In debug level, room join/leave information will be exposed. The info level (default) does not expose any user's private information.
  • easybridge_avatar: path to the image that Easybridge uses as an avatar on Matrix

Matrix configuration

  • registration: path to the YAML appservice registration file
  • appservice_bind_addr: on what IP/port to bind as a Matrix app service (HTTP only, no HTTPS)
  • homeserver_url: HTTP address of the Matrix homeserver
  • matrix_domain: the domain name of the Matrix homeserver (i.e. the domain used in user identifiers, room identifiers, etc)
  • name_format: the format of identifiers that are created on Matrix for users and room aliases. {} is replaced by the concatenation of user/room identifier and protocol. Typically you want either _ezbr_{} or {}_ezbr, the latter having the advantage that the briged user's names are then used as prefixes for the created identifiers.

Web interface configuration

  • web_bind_addr: on what IP/port to bind for the web interface that allows adding and configuring accounts (HTTP only, no HTTPS, use a reverse proxy for that)
  • web_url: the outside HTTP/HTTPS address at which the web interface is made available. If set, a widget will be added in the Easybridge room so that users can configure the bridge without leaving the Riot client.
  • session_key: a key with which session cookies are encrypted for the web interface

Storage configuration