5
0
mirror of https://github.com/cwinfo/matterbridge.git synced 2024-11-09 16:50:30 +00:00

Update documentation

This commit is contained in:
Wim 2016-09-04 20:41:03 +02:00
parent 12389d602e
commit 39043f3fa4
3 changed files with 123 additions and 31 deletions

View File

@ -1,36 +1,41 @@
# matterbridge # matterbridge
Simple bridge between mattermost and IRC. Simple bridge between mattermost, IRC, XMPP and Gitter
* Relays public channel messages between mattermost and IRC. * Relays public channel messages between mattermost, IRC, XMPP and Gitter. Pick and mix.
* Supports multiple mattermost and irc channels. * Supports multiple channels.
* Matterbridge -plus also works with private groups on your mattermost. * Matterbridge -plus also works with private groups on your mattermost.
This project has now [matterbridge-plus](https://github.com/42wim/matterbridge-plus/) merged in. Look at [matterbridge.conf.sample] (https://github.com/42wim/matterbridge/blob/master/matterbridge.conf.sample) for documentation and an example.
Breaking changes for matterbridge can be found in [migration](https://github.com/42wim/matterbridge/blob/master/migration.md)
Look at [matterbridge.conf.sample] (https://github.com/42wim/matterbridge/blob/master/matterbridge.conf.sample) for an example.
Configuration changes since v0.5.0 can be found in [changelog.md] (https://github.com/42wim/matterbridge/blob/master/changelog.md) ## Changelog
Since v0.6.0-beta support for XMPP and Gitter is added. More details in [changelog.md] (https://github.com/42wim/matterbridge/blob/master/changelog.md)
## Requirements: ## Requirements:
Accounts to one of the supported bridges
* [Mattermost] (https://github.com/mattermost/platform/) * [Mattermost] (https://github.com/mattermost/platform/)
* [IRC] (http://www.mirc.com/servers.html)
### Compatibility * [XMPP] (https://jabber.org)
* Matterbridge v0.6.0 works with mattermost 3.3.0 and higher [3.3.0 release](https://github.com/mattermost/platform/releases/tag/v3.3.0) * [Gitter] (https://gitter.im)
* Matterbridge v0.5.0 works with mattermost 3.0.0 - 3.2.0 [3.2.0 release](https://github.com/mattermost/platform/releases/tag/v3.2.0)
### Webhooks version
* Configured incoming/outgoing [webhooks](https://www.mattermost.org/webhooks/) on your mattermost instance.
### Plus (API) version
* A dedicated user(bot) on your mattermost instance.
## binaries ## binaries
Binaries can be found [here] (https://github.com/42wim/matterbridge/releases/) Binaries can be found [here] (https://github.com/42wim/matterbridge/releases/)
* For use with mattermost 3.3.0 [v0.6.0-beta1](https://github.com/42wim/matterircd/releases/tag/v0.6.0-beta1) * For use with mattermost 3.3.0 [v0.6.0-beta1](https://github.com/42wim/matterircd/releases/tag/v0.6.0-beta1)
* For use with mattermost 3.0.0-3.2.0 [v0.5.0](https://github.com/42wim/matterircd/releases/tag/v0.5.0) * For use with mattermost 3.0.0-3.2.0 [v0.5.0](https://github.com/42wim/matterircd/releases/tag/v0.5.0)
## Compatibility
### Mattermost
* Matterbridge v0.6.0 works with mattermost 3.3.0 and higher [3.3.0 release](https://github.com/mattermost/platform/releases/tag/v3.3.0)
* Matterbridge v0.5.0 works with mattermost 3.0.0 - 3.2.0 [3.2.0 release](https://github.com/mattermost/platform/releases/tag/v3.2.0)
#### Webhooks version
* Configured incoming/outgoing [webhooks](https://www.mattermost.org/webhooks/) on your mattermost instance.
#### Plus (API) version
* A dedicated user(bot) on your mattermost instance.
## building ## building
Go 1.6+ is required. Make sure you have [Go](https://golang.org/doc/install) properly installed, including setting up your [GOPATH] (https://golang.org/doc/code.html#GOPATH) Go 1.6+ is required. Make sure you have [Go](https://golang.org/doc/install) properly installed, including setting up your [GOPATH] (https://golang.org/doc/code.html#GOPATH)

View File

@ -1,3 +1,7 @@
# v0.6.0-beta2
## New features
* Gitter support added. See matterbridge.conf.sample for more information
# v0.6.0-beta1 # v0.6.0-beta1
## Breaking changes from 0.5 to 0.6 ## Breaking changes from 0.5 to 0.6
### commandline ### commandline
@ -20,3 +24,56 @@ Add ```Enabled=true``` or ```Enabled``` to the ```[mattermost]``` section if you
* RemoteNickFormat {BRIDGE} variable added * RemoteNickFormat {BRIDGE} variable added
You can now add the originating bridge to ```RemoteNickFormat``` You can now add the originating bridge to ```RemoteNickFormat```
eg ```RemoteNickFormat="[{BRIDGE}] <{NICK}> "``` eg ```RemoteNickFormat="[{BRIDGE}] <{NICK}> "```
# v0.5.0
## Breaking changes from 0.4 to 0.5 for matterbridge (webhooks version)
### IRC section
#### Server
Port removed, added to server
```
server="irc.freenode.net"
port=6667
```
changed to
```
server="irc.freenode.net:6667"
```
#### Channel
Removed see Channels section below
#### UseSlackCircumfix=true
Removed, can be done by using ```RemoteNickFormat="<{NICK}> "```
### Mattermost section
#### BindAddress
Port removed, added to BindAddress
```
BindAddress="0.0.0.0"
port=9999
```
changed to
```
BindAddress="0.0.0.0:9999"
```
#### Token
Removed
### Channels section
```
[Token "outgoingwebhooktoken1"]
IRCChannel="#off-topic"
MMChannel="off-topic"
```
changed to
```
[Channel "channelnameofchoice"]
IRC="#off-topic"
Mattermost="off-topic"
```

View File

@ -34,13 +34,14 @@ Nick="matterbot"
NickServNick="nickserv" NickServNick="nickserv"
NickServPassword="secret" NickServPassword="secret"
#RemoteNickFormat defines how Mattermost users appear on irc #RemoteNickFormat defines how remote users appear on this bridge
#The string "{NICK}" (case sensitive) will be replaced by the actual nick / username. #The string "{NICK}" (case sensitive) will be replaced by the actual nick / username.
#OPTIONAL (default NICK:) #The string "{BRIDGE}" (case sensitive) will be replaced by the sending bridge
RemoteNickFormat="{NICK}: " #OPTIONAL (default {BRIDGE}-{NICK})
RemoteNickFormat="[{BRIDGE}] <{NICK}>
#Nicks you want to ignore. #Nicks you want to ignore.
#Messages from those users will not be sent to mattermost. #Messages from those users will not be sent to other bridges.
#OPTIONAL #OPTIONAL
IgnoreNicks="ircspammer1 ircspammer2" IgnoreNicks="ircspammer1 ircspammer2"
@ -134,18 +135,19 @@ SkipTLSVerify=true
#OPTIONAL (default false) #OPTIONAL (default false)
ShowJoinPart=false ShowJoinPart=false
#Whether to prefix messages from IRC to mattermost with the sender's nick. #Whether to prefix messages from other bridges to mattermost with the sender's nick.
#Useful if username overrides for incoming webhooks isn't enabled on the #Useful if username overrides for incoming webhooks isn't enabled on the
#mattermost server. If you set PrefixMessagesWithNick to true, each message #mattermost server. If you set PrefixMessagesWithNick to true, each message
#from IRC to Mattermost will by default be prefixed by "irc-" + nick. You can, #from bridge to Mattermost will by default be prefixed by "bridge-" + nick. You can,
#however, modify how the messages appear, by setting (and modifying) RemoteNickFormat #however, modify how the messages appear, by setting (and modifying) RemoteNickFormat
#OPTIONAL (default false) #OPTIONAL (default false)
PrefixMessagesWithNick=false PrefixMessagesWithNick=false
#RemoteNickFormat defines how IRC users appear on Mattermost. #RemoteNickFormat defines how remote users appear on this bridge
#The string "{NICK}" (case sensitive) will be replaced by the actual nick / username. #The string "{NICK}" (case sensitive) will be replaced by the actual nick / username.
#OPTIONAL (default irc-NICK) #The string "{BRIDGE}" (case sensitive) will be replaced by the sending bridge
RemoteNickFormat="irc-{NICK}" #OPTIONAL (default {BRIDGE}-{NICK})
RemoteNickFormat="[{BRIDGE}] <{NICK}>
#how to format the list of IRC nicks when displayed in mattermost. #how to format the list of IRC nicks when displayed in mattermost.
#Possible options are "table" and "plain" #Possible options are "table" and "plain"
@ -155,10 +157,34 @@ NickFormatter=plain
#OPTIONAL (default 4) #OPTIONAL (default 4)
NicksPerRow=4 NicksPerRow=4
#Nicks you want to ignore. Messages from those users will not be sent to IRC. #Nicks you want to ignore. Messages from those users will not be bridged.
#OPTIONAL #OPTIONAL
IgnoreNicks="mmbot spammer2" IgnoreNicks="mmbot spammer2"
###################################################################
#Gitter section
#Best to make a dedicated gitter account for the bot.
###################################################################
[Gitter]
#Enable enables this bridge
#OPTIONAL (default false)
Enable=true
#Token to connect with Gitter API
#You can get your token by going to https://developer.gitter.im/docs/welcome and SIGN IN
#REQUIRED
Token="Yourtokenhere"
#Nicks you want to ignore. Messages of those users will not be bridged.
#OPTIONAL
IgnoreNicks="spammer1 spammer2"
#RemoteNickFormat defines how remote users appear on this bridge
#The string "{NICK}" (case sensitive) will be replaced by the actual nick / username.
#The string "{BRIDGE}" (case sensitive) will be replaced by the sending bridge
#OPTIONAL (default {BRIDGE}-{NICK})
RemoteNickFormat="[{BRIDGE}] <{NICK}>
################################################################### ###################################################################
#multiple channel config #multiple channel config
################################################################### ###################################################################
@ -166,17 +192,21 @@ IgnoreNicks="mmbot spammer2"
#The name is just an identifier for you. #The name is just an identifier for you.
#REQUIRED (at least 1 channel) #REQUIRED (at least 1 channel)
[Channel "channel1"] [Channel "channel1"]
#Choose the IRC channel to send mattermost messages to. #Choose the IRC channel to send messages to.
IRC="#off-topic" IRC="#off-topic"
#Choose the mattermost channel to send IRC messages to. #Choose the mattermost channel to messages to.
mattermost="off-topic" mattermost="off-topic"
#Choose the mattermost channel to send IRC messages to. #Choose the xmpp channel to send messages to.
xmpp="off-topic" xmpp="off-topic"
#Choose the Gitter channel to send messages to.
#Gitter channels are named "user/repo"
gitter="42wim/matterbridge"
[Channel "testchannel"] [Channel "testchannel"]
IRC="#testing" IRC="#testing"
mattermost="testing" mattermost="testing"
xmpp="testing" xmpp="testing"
gitter="user/repo"
################################################################### ###################################################################
#general #general