All Projects → 42wim → Matterircd

42wim / Matterircd

Licence: mit
Connect to your mattermost or slack using your IRC-client of choice.

Programming Languages

go
31211 projects - #10 most used programming language

Projects that are alternatives of or similar to Matterircd

st2chatops
Packaging environment for building StackStorm chatops native packages
Stars: ✭ 26 (-89.21%)
Mutual labels:  slack, irc, mattermost
Matterbridge
bridge between mattermost, IRC, gitter, xmpp, slack, discord, telegram, rocketchat, twitch, ssh-chat, zulip, whatsapp, keybase, matrix, microsoft teams, nextcloud, mumble, vk and more with REST API (mattermost not required!)
Stars: ✭ 4,452 (+1747.3%)
Mutual labels:  mattermost, slack, irc
Torpedo
Pluggable, multi-network asynchronous chat bot written in Go
Stars: ✭ 19 (-92.12%)
Mutual labels:  slack, irc
Irackbot
Bridge between Slack and IRC channels allowing message filtering and logging while keeping communication public
Stars: ✭ 25 (-89.63%)
Mutual labels:  slack, irc
Marvin
The paranoid bot (framework)
Stars: ✭ 51 (-78.84%)
Mutual labels:  slack, irc
Sactive Bot
😈 An extensible chat bot framework. sactive-bot is an evolution of the open source hubot project. - https://www.shipengqi.top/sactive-bot .
Stars: ✭ 212 (-12.03%)
Mutual labels:  mattermost, slack
Yetibot
🤖 Extreme chatops bot for Slack and IRC 🔧 New contributors welcome 🏗
Stars: ✭ 311 (+29.05%)
Mutual labels:  slack, irc
Octoslack
OctoPrint plugin for Slack, Mattermost, Pushbullet, Pushover, Rocket.Chat, Discord, Riot/Matrix, & Microsoft Teams
Stars: ✭ 50 (-79.25%)
Mutual labels:  mattermost, slack
notify
推送通知 sdk(Bark、Chanify、钉钉群机器人、Discord、邮件、飞书群机器人、Gitter、Google Chat、iGot、Logger、Mattermost、Now Push、PushBack、Push、PushDeer、PushPlus、QQ 频道机器人、Rocket Chat、Server 酱、Showdoc Push、Slack、Telegram、Webhook、企业微信群机器人、息知、Zulip)。
Stars: ✭ 335 (+39%)
Mutual labels:  slack, mattermost
Graylog Plugin Slack
Graylog alarm callback for Slack
Stars: ✭ 110 (-54.36%)
Mutual labels:  mattermost, slack
Localslackirc
IRC gateway for slack, running on localhost for one user
Stars: ✭ 84 (-65.15%)
Mutual labels:  slack, irc
Tfsnotificationrelay
An extensible plugin for TFS that sends notifications to Slack, HipChat and IRC
Stars: ✭ 120 (-50.21%)
Mutual labels:  slack, irc
Papercups
Open-source live customer chat
Stars: ✭ 4,554 (+1789.63%)
Mutual labels:  slack, mattermost
monolog-http
A collection of monolog handlers that use a PSR-18 HTTP Client to send your logs
Stars: ✭ 34 (-85.89%)
Mutual labels:  slack, mattermost
Irslackd
Self-hosted IRC gateway to Slack
Stars: ✭ 128 (-46.89%)
Mutual labels:  slack, irc
Mattermost Openshift
An OpenShift 3 application template for mattermost
Stars: ✭ 27 (-88.8%)
Mutual labels:  mattermost, slack
Gatus
⛑ Gatus - Automated service health dashboard
Stars: ✭ 1,203 (+399.17%)
Mutual labels:  mattermost, slack
Irc Slack
IRC-to-Slack gateway
Stars: ✭ 123 (-48.96%)
Mutual labels:  slack, irc
Phabulous
A Phabricator bot for Slack
Stars: ✭ 222 (-7.88%)
Mutual labels:  slack, irc
Slack Ruby Bot Server
A library that enables you to write a complete Slack bot service with Slack button integration, in Ruby.
Stars: ✭ 225 (-6.64%)
Mutual labels:  slack

matterircd

Join the IRC chat at https://webchat.freenode.net/?channels=matterircd

Minimal IRC server which integrates with mattermost and slack Tested on FreeBSD / Linux / Windows

Compatibility

  • Matterircd works with slack and mattermost 5.x

Master branch of matterircd should always work against latest STABLE mattermost release.

Features

  • support direct messages / private channels / edited messages / deleted messages / reactions
  • auto-join/leave to same channels as on mattermost
  • reconnects with backoff on mattermost restarts
  • support multiple users
  • support channel/direct message backlog (messages when you're disconnected from IRC/mattermost)
  • search messages (/msg mattermost search query)
  • scrollback support (/msg mattermost scrollback #channel limit)
  • away support
  • restrict to specified mattermost instances
  • set default team/server
  • WHOIS, WHO, JOIN, LEAVE, NICK, LIST, ISON, PRIVMSG, MODE, TOPIC, LUSERS, AWAY, KICK, INVITE support
  • support TLS (ssl)
  • support unix sockets
  • support LDAP logins (mattermost enterprise) (use your ldap account/pass to login)
  • &users channel that contains members of all teams (if mattermost is so configured) for easy messaging
  • support for including/excluding channels from showing up in irc
  • supports mattermost roles (shows admins with @ status for now)
  • gitlab auth hack by using mmtoken cookie (see https://github.com/42wim/matterircd/issues/29)
  • mattermost personal token support
  • support multiline pasting
  • prefixcontext option for mattermost (see https://github.com/42wim/matterircd/blob/master/prefixcontext.md)
  • ....

Binaries

You can find the binaries here

Building

Go 1.14+ is required

go get github.com/42wim/matterircd

You should now have matterircd binary in the bin directory:

$ ls ~/go/bin/
matterircd

Config file

See matterircd.toml.example
Run with matterircd --conf matterircd.toml

Usage

Usage of ./matterircd:
      --bind string      interface:port to bind to, or a path to bind to a Unix socket. (default "127.0.0.1:6667")
      --conf string      config file (default "matterircd.toml")
      --debug            enable debug logging
      --tlsbind string   interface:port to bind to. (e.g 127.0.0.1:6697)
      --tlsdir string    directory to look for key.pem and cert.pem. (default ".")
      --version          show version

Matterircd will listen by default on localhost port 6667. Connect with your favorite irc-client to localhost:6667

For TLS support you'll need to generate certificates.
You can use this program generate_cert.go to generate key.pem and cert.pem

Mattermost user commands

Login with user/pass

/msg mattermost login <server> <team> <username/email> <password>

Login with personal token

/msg mattermost login <server> <team> <username/email> token=<yourpersonaltoken>

Login with MFA token

/msg mattermost login <server> <team> <username/email> <password> MFAToken=<mfatoken>

Search

/msg mattermost search query

Scrollback

/msg mattermost scrollback <channel> <limit>
e.g. /msg mattermost scrollback #bugs 100 shows the last 100 messages of #bugs

Mark messages in a channel/from a user as read (when DisableAutoView is set).

/msg mattermost updatelastviewed <channel>
/msg mattermost updatelastviewed <username>

Slack user commands

Get a slack token on https://api.slack.com/custom-integrations/legacy-tokens

Login

/msg slack login <token>

Or use team/login/pass to login

/msg slack login <team> <login> <password>

After login it'll show you a token you can use for the token login

Docker

A docker image for easily setting up and running matterircd on a server is available at docker hub.

Run the irc server on port 6667. You'll need to specify -bind 0.0.0.0:6667 otherwise it only listens on 127.0.0.1 in the container.

docker run -p 6667:6667 42wim/matterircd:latest -bind 0.0.0.0:6667

Now you can connect with your IRC client to port 6667 on your docker host.

FreeBSD

Install the port.

# pkg install matterircd

Or with a local ports tree.

$ cd /usr/ports/net-im/matterircd
# make install clean

Enable the service.

echo "matterircd_enable="YES" >> /etc/rc.conf

Copy the default configuration and modify to your needs.

# cp /usr/local/etc/matterircd/matterircd.toml.sample /usr/local/etc/matterircd/matterircd.toml

Start the service.

# service matterircd start

Support/questions

We're also on the #matterircd channel on irc.freenode.net

FAQ

mattermost login with sso/gitlab

You'll need to get the MMAUTHTOKEN from your cookies, login via the browser first.
Then in chrome run F12 - application - Storage/cookies - select your mattermostdomain and fetch the MMAUTHTOKEN

Now login with /msg mattermost login <username> MMAUTHTOKEN=<mytoken>

See https://github.com/42wim/matterircd/issues/29 for more information

Also see #98 for a script that fetches it for you.

slack sso login / xoxc tokens

Taken from: https://github.com/insomniacslk/irc-slack

Log via browser on the Slack team, open the browser's network tab in the developer tools, and look for an XHR transaction. Then look for the token (it starts with xoxc-) in the request data the auth cookie, contained in the d key-value in the request cookies (it looks like d=XXXX;)

Then concatenate the token and the auth cookie using a | character, like this:

xoxc-XXXX|d=XXXX; and use the above as your token with slack login

/msg slack login xoxc-XXXX|d=XXXX;

Guides

Here are some external guides and documentation that might help you get up and running more quickly:

Related

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].