An Electron app to help with logging into bridges
  • TypeScript 87.8%
  • CSS 8.6%
  • JavaScript 3.1%
  • HTML 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-28 16:31:45 +02:00
.github/workflows Fix lint action 2026-07-06 23:14:00 +03:00
src Add support for default field values 2026-08-04 14:20:40 +03:00
.editorconfig Build DMG for macOS 2024-08-06 12:40:09 +03:00
.gitignore Initial commit 2024-07-28 02:38:09 +03:00
.npmrc Update dependencies 2026-06-30 22:03:29 +03:00
CONTRIBUTING.md .github: make contributing.md more visible 2026-10-28 16:14:55 +02:00
eslint.config.js Fix linters 2026-07-06 23:12:24 +03:00
forge.config.ts Build zips for linux 2026-07-17 01:32:45 +03:00
forge.env.d.ts Downgrade some packages and update vite files 2025-07-28 14:02:06 +03:00
icon.icns Add .ico and .icns icons 2024-08-06 12:47:01 +03:00
icon.ico Add .ico and .icns icons 2024-08-06 12:47:01 +03:00
icon.png Add app icon 2024-07-28 02:44:16 +03:00
index.html Initial commit 2024-07-28 02:38:09 +03:00
LICENSE Initial commit 2024-07-28 02:38:09 +03:00
package-lock.json Update dependencies 2026-10-28 16:31:45 +02:00
package.json Update dependencies 2026-10-28 16:31:45 +02:00
README.md Update readme 2024-08-04 23:59:51 +03:00
tsconfig.json Fix linters 2026-07-06 23:12:24 +03:00
vite.main.config.ts Add support for WebAuthn login step type 2026-07-06 23:14:28 +03:00
vite.preload.config.ts Fix linters 2026-07-06 23:12:24 +03:00
vite.renderer.config.ts Fix linters 2026-07-06 23:12:24 +03:00

mautrix-manager

An Electron app to help with logging into bridges.

All bridges using the new bridgev2 framework in mautrix-go are supported, as well as any bridges implementing the same provisioning API. Note that old mautrix bridges are not supported.

Discussion

Matrix room: #manager:maunium.net

Auto-configuration

You can always add bridge URLs inside mautrix-manager, but to make setup easier for users, the server admin can configure a .well-known file which is used to auto-discover available bridges.

On startup, mautrix-manager will fetch /.well-known/matrix/mautrix and read a list of URLs in the fi.mau.bridges property. For example, if you had Signal and Slack bridges and bridges.example.com configured to proxy /signal/* and /slack/* to the corresponding bridges, you'd probably want a well-known file like this:

{
  "fi.mau.bridges": [
    "https://bridges.example.com/signal",
    "https://bridges.example.com/slack"
  ]
}

The list MUST NOT include bridges that are connected to other servers, as the manager will send your Matrix access token to the bridges. If you want to add bridges on other servers, use the fi.mau.external_bridge_servers property instead. When specified, mautrix-manager will go through the list and fetch the .well-known file for each server. It will not recurse into the external servers list of an already-external server.

{
  "fi.mau.external_bridge_servers": [
    "anotherserver.example.org"
  ]
}

For bridges on external servers, the manager will generate an OpenID token and exchange it for a temporary bridge-specific auth token rather than sending your Matrix access token to the bridge.