matrix-appservice-mumble

A Matrix to Mumble bridge. It sends messages between bridged rooms and tells you when people join / leave Murmur.

Installation

Compiling Murmur with gRPC support

Murmur is not compiled with gRPC support by default (as of 1.3.0). If you are using Fedora or CentOS, I have a COPR that you can use. Otherwise, you will need to compile Murmur yourself. I have some basic notes and directions on compiling Murmur here.

Setup bridge

1. Install

   Using npm:

   npm install --global matrix-appservice-mumble

   Manually:

   Download the latest release and build

   npm i
   ./build.sh

2. Configure your homeserver

   1. Use matrix-appservice-mumble to generate mumble-registration.yaml
      Replace "http://localhost:port" with the address your homeserver will use to talk with matrix-appservice-mumble.

   The port matrix-appservice-mumble uses can be set with -p. (Default is 8090)

   # Replace "http://localhost:port" with the address your homeserver will use to talk
   # with matrix-appservice-mumble. The port matrix-appservice-mumble uses can be set with -p.
   matrix-appservice-mumble -r -u "http://localhost:port"

   2. Copy mumble-registration.yaml to your homeserver install directory, e.g. /etc/matrix-synapse/

   3. Edit homeserver.yaml and add the path to the just generated mumble-registration.yaml.

   # A list of application service config files to use
   #
   app_service_config_files:
    - /etc/matrix-synapse/mumble-registration.yaml

3. Create a new file named mumble-config.yaml on the server that matrix-appservice-mumble is installed on.

4. Copy the contents of mumble-config.yaml.example into mumble-config.yaml and change the options as needed.

5. Start the bridge

$ matrix-appservice-mumble -c /path/to/mumble-config.yaml -f /path/to/mumble-registration.yaml`

Troubleshooting

Matrix -> Murmr not working

• Can you curl url in mumble-config.yaml from the homeserver?
  • Check firewall configuration
  • Check if matrix-appservice-mumble is running
  • Check logs
  • Check mumble-registration.yaml on both sides (should be in working directory of matrix-appservice-mumble and on homeserver)