Node.js IRC bridge for Matrix
  • TypeScript 73%
  • JavaScript 26.4%
  • CSS 0.3%
  • Shell 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Jason Robinson d3edeaa830 4.0.1
2026-10-26 15:44:53 +02:00
.github Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00
bin util.inspect the IrcClient, add suitable overrides for inspect() on IRC bridge classes 2016-06-23 13:12:04 +01:00
changelog.d 4.0.0 2025-10-24 12:42:38 +03:00
contrib Reduce mentions of specific IRC networks, preferring to link to the network page 2021-08-17 10:05:53 +01:00
docker Fix port specified in config not being used in Docker (#1654) 2023-01-17 10:45:35 -05:00
docs Libera Chat bridge is down (#1784) 2024-01-25 08:59:56 +00:00
scripts Make towncrier build the changelog instead of printing its version 2022-03-22 14:38:01 +01:00
spec Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00
src Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00
widget Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00
.eslintrc Add a test to ensure that the irc client state doesn't bloat on VERSION (#1753) 2023-07-28 10:06:42 +01:00
.gitignore Add new setup widget UI (#1656) 2023-02-08 11:02:21 -05:00
.node-version Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00
.npmignore v0.18.0 2020-06-26 14:18:49 +01:00
app.js Fix CLI Error: undefined when error happens 2021-05-24 15:10:26 -07:00
book.toml Fix documentation builds and pull in version picker (#1703) 2023-04-28 11:47:30 +01:00
CHANGELOG.md 4.0.1 2026-10-26 15:44:53 +02:00
config.sample.yaml Integrate MediaProxy to bridge authenticated Matrix media (MSC3916) (#1805) 2024-09-02 12:21:13 +02:00
config.schema.yml Integrate MediaProxy to bridge authenticated Matrix media (MSC3916) (#1805) 2024-09-02 12:21:13 +02:00
CONTRIBUTING.md 4.0.0 2025-10-24 12:42:38 +03:00
Dockerfile Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00
Dockerfile.README.md Make the default port (8090) documented and used consistently (#1427) 2022-11-21 10:17:43 +01:00
HOWTO.md Remove outdated HOWTO.md content with a link to our docs 2021-08-17 10:06:13 +01:00
LICENSE Initial commit 2015-03-10 14:42:06 +00:00
package.json 4.0.1 2026-10-26 15:44:53 +02:00
pyproject.toml Ignore .gitkeep files in towncrier checks (#1813) 2024-09-02 11:54:45 +02:00
README.md docs: Fix typos (#1599) 2022-09-23 02:21:08 +02:00
tsconfig.json Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00
yarn.lock Update matrix-appservice-bridge to fix IO.ELEMENT.MSC4190.M_APPSERVICE_LOGIN_UNSUPPORTED error with MSC4190 enabled homeservers (#1858) 2025-10-24 12:22:18 +03:00

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.