Other bridges ?

Question

Other bridges ?

42wim opened this issue 8 years ago · 147 comments

Answer 1 · 2016-09-04T19:18:17.000Z

Currently supported: IRC, mattermost, gitter, xmpp
Next in line: slack
To be considered: whatsapp, fb messenger, mail

Answer 2 · 2016-09-04T19:19:11.000Z

Sidenote:
Awesome project and thanks for taking the time and publishing it openly.

Answer 3 · 2016-09-07T06:07:13.000Z

Support for Rocket.Chat would be great. See https://github.com/RocketChat/Rocket.Chat

Answer 4 · 2016-09-11T12:25:52.000Z

Thanks for the feedback.
I'm also trying to make the config more flexible to combine multiple bridges in a gateway, more or less like the example in issue #9

Any comments ?

[Bridge "mattermost1"]
protocol=mattermost
..mattermostoptions..

[Bridge "irc1"]
protocol=irc
..ircoptions..

[Bridge "irc2"]
protocol=irc
..ircoptions..

[Bridge "gitter1"]
protocol=gitter
..gitteroptions..

[Channel "test"]
mattermost="testing"
irc="#test"

[Channel "stuff"]
mattermost="general"
irc="#stuff"
gitter="42wim/stuff"

[Gateway "gateway1"]
bridge=mattermost1
bridge=irc1
channel=test
enable

[Gateway "test2"]
bridge=mattermost1
bridge=irc2
bridge=gitter1
channel=stuff
enable

Answer 5 · 2016-09-17T12:59:29.000Z

Would like to suggest discord support :) reactiflux/discord-irc#100

Answer 6 · 2016-09-19T18:56:35.000Z

@jleclanche well, discord support has just been added in current master ;-)
Also decided to use your TOML configuration file because gcfg was not expressive enough.

Answer 7 · 2016-10-07T06:50:31.000Z

would like Telegram https://github.com/FruitieX/teleirc

Answer 8 · 2016-10-08T20:53:54.000Z

@lagleki unfortunately telegram needs a phone-number to join (and I'm not willing to give mine). On the other hand the bot API is implemented in Go, so it would be quite easy to add it.

If you're willing to be my test-user I can try to add it.

Answer 9 · 2016-10-11T14:45:18.000Z

Unsure how easy it'd be to add, but being able to bridge to hipchat would be a nice to have.

Answer 10 · 2016-11-14T00:19:17.000Z

@42wim I'll gladly offer myself for that (telegram), might even (if I find enough spare time) send a PR

Answer 11 · 2016-11-15T22:36:37.000Z

@jlsjonas thanks! Please let me know the results in #80

Answer 12 · 2016-11-28T00:31:31.000Z

Would be really nice to see mattermost to Skype group chat. Sameroom.io offers this as service so I imagine they are using Microsoft's API. This would be worth making a donation on its own.

Answer 13 · 2016-12-02T23:11:32.000Z

@tobru rocket.chat support got just added, feedback welcome :-)

Answer 14 · 2016-12-02T23:22:55.000Z

@pgladwin seems that there's a rest API for skype on https://docs.botframework.com/en-us/skype/chat/
That's good news, no .net SDK needed.

Answer 15 · 2017-02-14T09:02:02.000Z

Could a possible additional bridge to add be Matrix?

There are several already existing bridges and an Application Service API spec. (Though admittedly it's still marked as unstable)

Answer 16 · 2017-02-19T23:57:56.000Z

@Ace13 matrix support added in master :-)
For channel names you'll have to use the room internal ID (looks like !QJFqjsGJwmQzbuBfff:matrix.org)
You'll also need a dedicated bot user to avoid loops.

So for example

[matrix.test]
Server="https://yourhomeserver" (e.g. https://matrix.org)
Login="yourlogin"
Password="yourpass"

[[gateway]]
  enable=true
  [[gateway.inout]]
  account="matrix.test"
  channel="!QJFqjsGJwmQzbuBfff:matrix.org"

 [[gateway.inout]]
 ..your other bridges ..

Answer 17 · 2017-02-21T18:35:25.000Z

Got a question for Let's chat support (https://github.com/sdelements/lets-chat) but it seems quite dead to me. If you want this bridge added, please add the 👍 to this message.

Answer 18 · 2017-03-26T09:19:53.000Z

Line. It already has an API support in Go language too! 😉
https://devdocs.line.me/en/?go#messaging-api

Answer 19 · 2017-03-26T13:10:46.000Z

@tomoeuehara looks interesting, but signup unfortunately only works with phonenumber.

I'm willing to accept PR's for this protocol, or if someone sends me a test login/password (DM @42wim on twitter) I can take a look myself.

Answer 20 · 2017-03-26T13:48:56.000Z

@42wim DM sent :D

Answer 21 · 2017-04-25T06:23:49.000Z

If you do something like this:
[Channel "stuff"]
mattermost="general"
irc="#stuff"
gitter="42wim/stuff"

How will you know where your reply is going? If someone pings me on irc #stuff i dont want my replies going to gitter.

Answer 22 · 2017-04-26T20:18:20.000Z

@dantrevino That example was an old proposal, like you say it has some issues.

An example of the current configuration can be found in the README: https://github.com/42wim/matterbridge/#examples or sample config
https://github.com/42wim/matterbridge/blob/master/matterbridge.toml.simple

Answer 23 · 2017-05-09T07:00:36.000Z

Dear @42wim,

Your tube system looks exact what we need, only is the integration with skype something we would like to see.

It's on your list at the top, so can you give something of an status? Does it comes in an few days, weeks, months or was it only an idea and have you no plans to relize this idea?

Answer 24 · 2017-05-09T19:46:17.000Z

hi @Tck13

Thank you for your interest.

Skype doesn't have a go library, so I'll need to implement a lot myself (or wait until such a library pops up).
Which only could happen when I have a lot of free time, maybe july/august.

So sorry, but unless someone else implements it, it won't be available soon. (and I don't make any promises for july/august :-)

Answer 25 · 2017-05-11T10:16:58.000Z

@42wim Wechat Enterprise 企业微信 would be excellent! Most of these services are blocked and/or unusable here in China for various reasons, but wechat Enterprise is severely lacking. I was hoping to write a bridge between our slack org and wechat so that our foreign teams can use slack and our chinese teams can use wechat, but then I found this excellent project. Unfortunately I have no Go experience.

There does seem to be two different libraries, (https://github.com/chanxuehong/wechat.v2/ and https://github.com/chanxuehong/wechat) but my understanding of Go and chinese is too poor to really dig in and try to figure it out myself. However, I do know that Wechat enterprise 企业微信 has a robust API, with full support for incoming and outgoing webhooks:

http://qydev.weixin.qq.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5

A long shot, but let me know what you think.

Answer 26 · 2017-05-12T20:24:13.000Z

@nickolasclarke Thanks for the suggestion.

I see a couple of issues unfortunately.

documentation is too much chinese for me.
it needs a signup with a mobile phone. (I don't want to use this kind of service, so I can't test it)
wechat seems to have a lot of red tape for creating and testing accounts.

So this is not something I'm going to implement, but I'm happy to accept code from someone for who those 3 things aren't an issue.

Answer 27 · 2017-06-20T10:16:57.000Z

How about Steam and TOX support?

I am not sure if they would work but thats the two go-libs i found so far:
Steam --> https://github.com/Philipp15b/go-steam
TOX --> https://github.com/kitech/go-toxcore

Answer 28 · 2017-06-20T22:30:26.000Z

@TomTheDragon steam looks feasible, got a poc running :-) You willing to test soon ?:)
Haven't looked into tox yet

Answer 29 · 2017-06-21T22:31:08.000Z

@42wim sure, i really would like to test it :)

Answer 30 · 2017-06-21T23:16:55.000Z

@TomTheDragon it's in master now.

A couple of things:

Authentication

I only have it tested with 2FA enabled. If you have 2FA steamguard enabled you'll get a prompt to type in the 2FA code in when matterbridge starts.
Authcode by mail should also work, you can add that in the config or you'll get a prompt too. (not tested)
No steamguard enabled should just work. (not tested)
It works fine with your own account, but you better make a separate bot account if you really want to use this.

Channels

You cannot use channel names, you'll have to use the channel/chatids, a long number that you can find in the URL of your browser if you click on "enter this chat" room on a group page.

Please open a new issue for feedback/issues with the steam bridge.

[steam]
[steam.gamechat]
#login/pass of your bot.
#Use a dedicated user for this and not your own account!
#REQUIRED
Login="yourlogin"
Password="yourpass"

#steamguard mail authcode (not the 2FA code)
#OPTIONAL
Authcode="ABCE12"

[[gateway]]
  enable=true
  [[gateway.inout]]
  account="steam.gamechat"
  channel="12345678912345678"

 [[gateway.inout]]
 ..your other bridges ..

Answer 31 · 2017-06-22T09:16:36.000Z

@42wim seriously your ability to produce/hook up gateway after gateway really astounds me.

Answer 32 · 2017-06-22T10:48:38.000Z

@jleclanche thanks for the kind words, but the hard work is mostly done by the creators of the different libraries. I'm doing the easy part :-)

Answer 33 · 2017-06-25T23:33:37.000Z

@42wim
Steam works perfectly like it should, thx again :)
Had any luck with TOX so far?

Answer 34 · 2017-06-26T18:24:06.000Z

@TomTheDragon ok, nice to hear.

I've been looking into TOX, it seems still early (alpha releases) and it doesn't have pure go libraries.
So I'm not going to add it, but I'm open for PR if someone else wants to do this.

Answer 35 · 2017-07-02T16:35:51.000Z

@42wim
Hm.. ok then, would be really cool to see TOX support one day, since TOX is an really interesting and really great working (open) p2p/serverless protocol ;)

But how about Hangouts? I could not find any pure Hangouts go libs so far but maybe you can work with the Hangouts client they use in the Slangouts project? --> https://github.com/gpavlidi/slangouts

Answer 36 · 2017-07-07T22:11:20.000Z

@TomTheDragon Yes, I looked into the hangouts thing a while ago.
But it has some issues:

I couldn't get it to work with my test account
After looking into the code I saw it uses a dirty hack where I'm not comfortable with, see rogora/hangish#28

Answer 37 · 2017-07-10T18:53:11.000Z

Actually, Skype will be very desired.

May be it will even help more people to give up Skype finally %)

Skype doesn't have a go library, so I'll need to implement a lot myself (or wait until such a library pops up).

Haven't check it myself, but it looks like there is a sort of.

Answer 38 · 2017-07-17T08:29:09.000Z

For Skype bridging you can lookup code of https://github.com/EionRobb/skype4pidgin/tree/master/skypeweb project - it works with skype directly via web API.

Answer 39 · 2017-07-18T19:48:02.000Z

@MurzNN It is probably better to use third party library than to re-implement it for this project.

Rationale:

It is not official API and there is a big chance, it will change like ICQ protocol in late 2000-th. In the sme time, @42wim already does a lot of work integrating all the protocols together.

Answer 40 · 2017-08-03T13:30:20.000Z

Is anyone working on bridging Microsoft Teams?

Answer 41 · 2017-08-19T07:30:42.000Z

Vk.com is popular instant messaging service, based on social network, like Facebook.com.

Will be good to create mattermost bridge to it. The API must be almost same as in Facebook social network.

Here is projects that implement API librarites for Vkontakte:

And more via vk keyword: https://golanglibs.com/top?q=vk

Answer 42 · 2017-08-19T07:35:44.000Z

@dluciv here is third party node.js library for skype: https://github.com/ocilo/skype-http There are already Matrix bridge that work based on this library: https://github.com/matrix-hacks/matrix-puppet-skype
I'll try to find go implementation of it for mattermost.

Answer 43 · 2017-08-21T07:38:49.000Z

Here is Skype implementation in Go:

Answer 44 · 2017-08-22T05:49:18.000Z

Another suggestion is add support for libpurple library: libpurple project provide good API for work with many instant messaging services via one interface: https://developer.pidgin.im/wiki/WhatIsLibpurple

libpurple library already have plugins to many instant messaging services (XMPP, Telegram, Skype, etc), here is list of supported networks via plugins: https://developer.pidgin.im/wiki/ThirdPartyPlugins

So implementing support for libpurple library will add bridge ability to many networks at once.

Answer 45 · 2017-08-28T21:45:29.000Z

@MurzNN thanks for your time looking into this.

vk: haven't looked into it yet, may be possible (on my list to look at later)
skype: the 2 skype implementations in go you found are prototype/pocs and not usable
libpurple: there's a WIP for a purple go library https://github.com/kitech/go-purple but using this means using cgo and this won't work on windows. But if anyone wants to implement this, I'll merge that PR

@sapg AFAIK no one is looking into microsoft teams. To add this I need a go library or someone implementing this themselves.

Answer 46 · 2017-10-19T17:44:31.000Z

What would you think of RSS support? It would help with having only one bot doing all the bridging. I don't know if RSS output would be useful - maybe? At least RSS input, as with that you could get all the feeds you need in any chat matterbridge supports.

Answer 47 · 2017-10-19T21:30:14.000Z

@BFlorry I'm not sure how you see RSS, you want to poll a RSS feed and dump this info in a channel?

Answer 48 · 2017-10-20T07:43:42.000Z

Yes, RSS is good idea - poll RSS feed and post new articles to IM channels. Matrix.org IM have this feature via bot https://github.com/matrix-org/go-neb#user-content-rss-bot

Answer 49 · 2017-10-20T12:29:07.000Z

@42wim Yes, exactly. @MurzNN defined this better than me.

Answer 50 · 2017-10-20T15:29:34.000Z

That really sounds out of scope for matterbridge; the primary feature of the bridges being that they are 2-ways.

OTOH it makes a good case for a plugin system...

Answer 51 · 2017-10-20T16:54:32.000Z

Yes, that's out of scope.
I'm not sure of a plugin system either, I have a basic API that can be used for this.
@NikkyAI was creating a bot based on this https://github.com/NikkyAI/pyCord

I'm open for feedback on the API

Answer 52 · 2017-10-24T07:33:22.000Z

Will be good to see also bridge to Viber IM network - it have Bots and useful API https://developers.viber.com/docs/api/
And here https://github.com/strongo/bots-api-viber is Go library that implements it.

Answer 53 · 2017-11-04T06:23:14.000Z

Speaking of bot framework's rest api, support for that would allow support for:

https://docs.botframework.com/en-us/channel-inspector/channels/Facebook?f=GroupChat&e=example1

Answer 54 · 2017-11-16T19:52:50.000Z

Updated the initial message to summarize my answers about different bridges/protocols

Answer 55 · 2017-12-03T00:40:51.000Z

sshchat (https://github.com/shazow/ssh-chat) support added

Answer 56 · 2017-12-21T12:20:54.000Z

Threema is an widely used messenger, which also seems to have an open-source implementation on github --> https://github.com/o3ma

Answer 57 · 2018-01-11T07:09:34.000Z

Via https://github.com/strongo/bots-framework on Go language - we can easily add support for many messengers in once: Telegram, Facebook Messenger, Viber, Skype, Line, Kik, WeChat
@42wim, can you lookup how hard to add this framework in matterbridge?

Answer 58 · 2018-01-20T22:37:05.000Z

Added twitch support explicitly to the list (but it's just irc)

Answer 59 · 2018-01-21T11:35:14.000Z

@MurzNN see https://github.com/strongo/bots-framework/blob/master/can-i-use-bots-api.md it's just a WIP, only telegram works

Answer 60 · 2018-02-17T09:31:09.000Z

Mumble support (of course only its text chat) would be a really nice feature, and a go library already seems to exist: https://github.com/layeh/gumble

Answer 61 · 2018-03-30T00:09:36.000Z

Facebook Messenger would be cool.

Answer 62 · 2018-03-30T12:59:30.000Z

would there be support for creating a stub issue for each platform? that way, ppl can +1 and track updates and convo around the ones they care about, rather than a mega-thread? This thread could be converted into an epic that links the others from the OP

particularly interested in your perspective, @42wim

Potential To Dos

create a label: new-bridge-request
Create a stub for each bridge type (maybes and not-by-me's) and tag with label
- cc people who expressed interest in this thread
- copy relevant comments about libraries, etc.
edit original (summary) post in here to reference each issue

Answer 63 · 2018-04-01T21:56:33.000Z

That would create a lot of "low traffic" issues I think.
I try to keep the first comment updated with the current state.
Of course if the chatter in this thread would explode for a specific bridge, another issue can be opened.

Answer 64 · 2018-04-18T15:34:07.000Z

Zulip - https://github.com/zulip/zulip

Answer 65 · 2018-05-06T22:30:55.000Z

@jheiselman started working on Zulip, poc works. I hope you're willing to test the final version in a few days :)

Answer 66 · 2018-05-07T19:40:18.000Z

Zulip support has been added 🎉

Answer 67 · 2018-05-11T08:41:59.000Z

Skype would be pretty sweet. If someone wanted to tackle it and create an issue for it, I wouldn't mind tossing some cash on Bountysource or something for it.

Answer 68 · 2018-05-11T13:58:40.000Z

@54 Skype represents a unique pain point. There is no official API and the only SDK has to use the Microsoft's BotFramework platform. Further, their SDK is C# or Node.js only. Someone would have to take time to port it to Go.

Answer 69 · 2018-05-21T12:08:17.000Z

I have found fresher libraries for Viber in Go:

Also for Facebook: https://github.com/strongo/bots-api-fbm

And for VK:

@42wim If we don't plan to create separate issue for each messenger, can you update first message and add links to libraries for messengers, mentioned here?

Answer 70 · 2018-05-26T17:32:11.000Z

@MurzNN thanks for the update. I've added those. Facebook isn't an option though because it doesn't seem to support group chat for bots.

Answer 71 · 2018-06-13T10:43:19.000Z

signal - no golang library. PR welcome

There is a Go Signal library: https://github.com/RadicalApp/libsignal-protocol-go
Although it is a bit old ( Latest commit d09bcab on Apr 14, 2017 )

Answer 72 · 2018-06-13T21:09:39.000Z

As @jheiselman explains:

[discord] lil5: I took a look at that go library for libsignal-protocol-go and it only covers the encryption method, not the service API

- taken from the matterbridge chat

Answer 73 · 2018-09-29T00:02:53.000Z

@nickolasclarke I am author of vim-chat which support qq and weechat, and I would like to help test this two lib.

and I think you can also check mojo-webqq and mojo-weixin which are perl lib for qq and weechat.

Answer 74 · 2018-10-09T10:38:26.000Z

For WeChat we can also lookup https://github.com/littlecodersh/ItChat project in Go lang.

Answer 75 · 2018-10-28T10:06:13.000Z

FYI, Seems ppl are working on a tox fork: https://github.com/envsh/matterbridge

Asked about upstreaming here: envsh/matterbridge#24

cc @TomTheDragon

Answer 76 · 2018-12-04T04:54:01.000Z

@Jaykul suggested Spectrum: #628

It's a little different model than most, but it feels worth tracking. I can imagine a Zulip/Spectrum gateway feeling very natural to someone who prefers both.

Answer 77 · 2019-02-21T19:48:12.000Z

Thanks to @KrzysztofMadejski the Whatsapp protocol is now supported.

Answer 78 · 2019-05-20T08:50:31.000Z

There is this golang implementation for the signal protocol:
https://github.com/morph027/textsecure

It is used by this gateway project:
https://gitlab.com/morph027/signal-web-gateway

According to the issues it seems to be working.

Answer 79 · 2019-08-26T12:07:09.000Z

Not a general purpose golang library, but this could probably help getting a Microsoft Teams bridge to work:
https://github.com/bzon/prometheus-msteams

Answer 80 · 2019-08-26T19:06:02.000Z

Thanks to @hyperobject keybase bridging is now possible.

Answer 81 · 2019-09-23T09:31:03.000Z

Checked the Viber API, seems have they doesn't supports receiving messages, only sending.

Answer 82 · 2019-11-30T22:55:16.000Z

I've started working on Microsoft Teams support.
Looking for alpha/beta testers who have an active Teams (not just a test setup)
I'll open a new issue for further discussion about msteams if there are actually people with active setups who want to help test it.

Answer 83 · 2019-12-10T19:29:35.000Z

@42wim I'll gladly participate in testing msteams, we do (unfortunately) have a active msteams setup.

Answer 84 · 2019-12-10T21:07:34.000Z

@gardar what's the best way to contact you? If you're on twitter you can dm @42wim

Answer 85 · 2019-12-10T21:34:14.000Z

@42wim probably best to reach me @gardar on freenode

Answer 86 · 2019-12-13T20:48:44.000Z

There is this golang implementation for the signal protocol:
https://github.com/morph027/textsecure

More up to date version seems to be this:
https://github.com/nanu-c/textsecure/

Answer 87 · 2019-12-29T23:46:45.000Z

QQ support could be interesting, it would create access to chinas number one messaging network ;)
https://github.com/catsworld/qq-bot-api

Answer 88 · 2020-01-20T10:45:02.000Z

signal - no golang library. PR welcome

it seems like there are some by now :) https://github.com/RadicalApp/libsignal-protocol-go
anyone willing to do some work?

Answer 89 · 2020-02-25T21:25:30.000Z

Great work. Could it be possible to have bridge to Microsoft Teams as well? Teams seems to get populair and I have seen teams integrations with slack as well

Answer 90 · 2020-02-27T19:56:02.000Z

@pdwonline msteams support will be available in 1.17.x, you can try the PR here: #967

Answer 91 · 2020-03-09T18:53:13.000Z

Threema support would be awesome.

Answer 92 · 2020-03-26T09:58:50.000Z

Signal would be awesome!

Answer 93 · 2020-04-04T14:05:11.000Z

This might be a Go based library for a Nextcloud Talk bot:
https://github.com/pojntfx/nextcloud-talk-jitsi-bot

Answer 94 · 2020-04-12T17:22:14.000Z

Threema support would be awesome.

Could be a start, but apparently something changed in Threema and it stopped working:
https://github.com/genofire/thrempp

Answer 95 · 2020-04-19T06:43:46.000Z

An RSS/Atom feed?

Answer 96 · 2020-06-09T14:07:00.000Z

What about Wickr?

Answer 97 · 2020-07-25T12:13:38.000Z

Mozilla Hubs VR chat would be cool. https://hubs.mozilla.com/

There is a Golang based WIP bot-bridge to Matrix that might be a good starting point:
https://gitlab.com/rek2/gohubsbot

Answer 98 · 2020-08-27T15:36:17.000Z

would be nice to support for email

Answer 99 · 2020-09-10T10:14:11.000Z

QQ support could be interesting, it would create access to chinas number one messaging network ;)
https://github.com/catsworld/qq-bot-api

Any updates on this maybe? I can help if there is some testing that needs to be done.

Answer 100 · 2020-10-01T20:54:15.000Z

Forgot to update this issue:

Nextcloud Talk has been added in 1.18.0 - thanks to @gary-kim
Mumble has just been added - thanks to @s3lph

Other bridges ?

Bridges supported

Not supported anymore

3rd party via matterbridge API

Not going to be implemented by me, but PR's welcome

Obsolete

Authentication

Channels

Potential To Dos