lug/matterbridge
10
0
Fork 2
Code Issues 5 Pull Requests Actions Packages Projects Releases Wiki Activity

Update documentation

Browse Source
This commit is contained in:
Wim
2016-07-12 00:25:32 +02:00
parent 300cfe044a
commit 3bc25f4707
2 changed files with 91 additions and 76 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
README.md
View File

@@ -51,58 +51,7 @@ Matterbridge will:
### matterbridge ### matterbridge
matterbridge looks for matterbridge.conf in current directory. (use -conf to specify another file) matterbridge looks for matterbridge.conf in current directory. (use -conf to specify another file)
Look at matterbridge.conf.sample for an example Look at [matterbridge.conf.sample] (https://github.com/42wim/matterbridge/blob/master/matterbridge.conf.sample) for an example.
```
[IRC]
server="irc.freenode.net:6667"
#default no TLS connection to irc server
UseTLS=false
#do not check the certificate if we use TLS (allows for selfsigned certificates)
SkipTLSVerify=true
nick="matterbot"
#Freenode nickserv
NickServNick="nickserv"
#Password for nickserv
NickServPassword="secret"
#Ignore the messages from these nicks. They will not be sent to mattermost
IgnoreNicks="ircspammer1 ircspammer2"
[mattermost]
#url is your incoming webhook url (account settings - integrations - incoming webhooks)
url="http://mattermost.yourdomain.com/hooks/incomingwebhookkey"
#address the webserver (which receives the outgoing webhook from mattermost) will listen on
#(account settings - integrations - outgoing webhooks)
BindAddress="0.0.0.0:9999"
#show irc users joining and parting
showjoinpart=true
#the token you get from the outgoing webhook in mattermost.
Token="outgoingwebhooktoken1"
#disable certificate checking (selfsigned certificates)
#SkipTLSVerify=true
#whether to prefix messages from IRC to mattermost with the sender's nick. Useful if username overrides for incoming webhooks isn't enabled on the mattermost server
PrefixMessagesWithNick=false
#how to format the list of IRC nicks when displayed in mattermost. Possible options are "table" and "plain"
NickFormatter=plain
#how many nicks to list per row for formatters that support this
NicksPerRow=4
#Ignore the messages from these nicks. They will not be sent to irc
IgnoreNicks="mmbot spammer2"
#multiple channel config
[Channel "channel1"]
IRC="#off-topic"
mattermost="off-topic"
[Channel "testchannel"]
IRC="#testing"
mattermost="testing"
[general]
#request your API key on https://github.com/giphy/GiphyAPI. This is a public beta key
GiphyApiKey="dc6zaTOxFJmzC"
```
### mattermost ### mattermost
You'll have to configure the incoming en outgoing webhooks. You'll have to configure the incoming en outgoing webhooks.

114
matterbridge.conf.sample
View File

@@ -1,39 +1,105 @@
#This is configuration for matterbridge.
###################################################################
#IRC section
###################################################################
[IRC] [IRC]
server="irc.freenode.net" #irc server to connect to. REQUIRED
port=6667 Server="irc.freenode.net:6667"
#Enable to use TLS connection to your irc server. OPTIONAL (default false)
UseTLS=false UseTLS=false
#Enable to not verify the certificate on your irc server. OPTIONAL (default false)
#e.g. when using selfsigned certificates
SkipTLSVerify=true SkipTLSVerify=true
nick="matterbot"
channel="#matterbridge" #Your nick on irc. REQUIRED
UseSlackCircumfix=false Nick="matterbot"
#NickServNick="nickserv"
#NickServPassword="secret" #If you registered your bot with a service like Nickserv on freenode. OPTIONAL
NickServNick="nickserv"
NickServPassword="secret"
#Nicks you want to ignore. Messages from those users will not be sent to mattermost. OPTIONAL
IgnoreNicks="ircspammer1 ircspammer2" IgnoreNicks="ircspammer1 ircspammer2"
###################################################################
#mattermost section
###################################################################
[mattermost] [mattermost]
url="http://yourdomain/hooks/yourhookkey" #### Settings for webhook matterbridge.
port=9999 #### These settings will not be used when using -plus switch which doesn't use webhooks.
showjoinpart=true
#remove token when using multiple channels! #Url is your incoming webhook url as specified in mattermost. REQUIRED
token=yourtokenfrommattermost #See account settings - integrations - incoming webhooks on mattermost.
URL="https://yourdomain/hooks/yourhookkey"
#Address to listen on for outgoing webhook requests from mattermost. REQUIRED
#See account settings - integrations - outgoing webhooks on mattermost.
#This setting will not be used when using -plus switch which doesn't use webhooks
BindAddress="0.0.0.0:9999"
#Icon that will be showed in mattermost. OPTIONAL
#This setting will not be used when using -plus switch which doesn't use webhooks
IconURL="http://youricon.png" IconURL="http://youricon.png"
#SkipTLSVerify=true
#BindAddress="0.0.0.0" #### Settings for matterbridge -plus
#### Thse settings will only be used when using the -plus switch.
#The mattermost hostname. REQUIRED
Server="yourmattermostserver.domain"
#Your team on mattermost. REQUIRED
Team="yourteam"
#login/pass of your bot. Use a dedicated user for this and not your own! REQUIRED
Login="yourlogin"
Password="yourpass"
#https by default. Disable to make a http connection to your mattermost. OPTIONAL (default false)
NoTLS=false
#### Shared settings for matterbridge and -plus
#Enable to not verify the certificate on your mattermost server. OPTIONAL (default false)
#e.g. when using selfsigned certificates
SkipTLSVerify=true
#Enable to show IRC joins/parts in mattermost. OPTIONAL (default false)
ShowJoinPart=false
#Whether to prefix messages from IRC to mattermost with the sender's nick. OPTIONAL (default false)
#Useful if username overrides for incoming webhooks isn't enabled on the mattermost server
PrefixMessagesWithNick=false PrefixMessagesWithNick=false
#how to format the list of IRC nicks when displayed in mattermost. OPTIONAL (default plain)
#Possible options are "table" and "plain"
NickFormatter=plain NickFormatter=plain
#How many nicks to list per row for formatters that support this. OPTIONAL (default 4)
NicksPerRow=4 NicksPerRow=4
#Nicks you want to ignore. Messages from those users will not be sent to IRC. OPTIONAL
IgnoreNicks="mmbot spammer2" IgnoreNicks="mmbot spammer2"
[general] ###################################################################
GiphyAPIKey=dc6zaTOxFJmzC
#multiple channel config #multiple channel config
#token you can find in your outgoing webhook ###################################################################
[Token "outgoingwebhooktoken1"] #You can specify multiple channels. REQUIRED (at least 1 channel)
IRCChannel="#off-topic" #The name is just an identifier for you.
MMChannel="off-topic" [Channel "channel1"]
#Choose the IRC channel to send mattermost messages to.
IRC="#off-topic"
#Choose the mattermost channel to send IRC messages to.
mattermost="off-topic"
[Token "outgoingwebhooktoken2"] [Channel "testchannel"]
IRCChannel="#testing" IRC="#testing"
MMChannel="testing" mattermost="testing"
###################################################################
#general
###################################################################
[general]
#request your API key on https://github.com/giphy/GiphyAPI. This is a public beta key. OPTIONAL
GiphyApiKey="dc6zaTOxFJmzC"