Skip to content

matrix-org/matrix-appservice-irc

develop
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
December 5, 2022 15:10
src
January 23, 2023 23:15
June 26, 2020 14:18
October 25, 2022 09:47
March 10, 2015 14:42
September 23, 2022 02:21
December 5, 2022 15:10
September 25, 2019 14:43

Matrix IRC Bridge

Docker Image Version (latest semver) Build Status #irc:matrix.org

This is an IRC bridge for Matrix. If you're upgrading from an old release, be sure to read the CHANGELOG as there may be breaking changes between releases.

This bridge will pass all IRC messages through to Matrix, and all Matrix messages through to IRC. It is highly configurable and is currently used on the matrix.org homeserver to bridge a number of popular IRC networks.

We maintain a list of bridged IRC networks here.

What does it do?

On startup, the bridge will join Matrix clients to the IRC channels specified in the configuration file. It will then listen for incoming IRC messages and forward them through to Matrix rooms Each real Matrix user is represented by an IRC client, and each real IRC client is represented by a Matrix user. Full two-way communication in channels and PMs are supported, along with a huge array of customisation options.

Usage

To learn how to use the bridge, see our usage guide.

Setting up your own bridge

You will need a Matrix homeserver to run this bridge. Any homeserver that supports the AS API should work.

See the getting started docs for instructions on how to set up the bridge.

Configuration

See the sample config file for an explanation of the configuration options available.

Documentation

Documentation can be found on GitHub Pages.

You can build the documentaion yourself by:

# Ensure that Rust is installed on your system.
# cargo install mdbook
mdbook build
sensible-browser book/index.html

Contributing

Please see the CONTRIBUTING file for information on contributing.