Merge pull request #4118 from nextcloud/enh/4096/custom-binary-doc

Add link to doc explaining how to customize matterbridge binary path

docs/matterbridge.md

@@ -0,0 +1,15 @@
+# Matterbridge integration
+
+While we tried to keep the setup and integration as smooth as possible, we also wanted to make sure you can get fixes on the matterbridge as soon as possible and don't have to wait until we made a new Talk release available. Therefor we decided to put the [Matterbridge binary from 42wim](https://github.com/42wim/matterbridge) into a separate app in the [appstore](https://apps.nextcloud.com/apps/talk_matterbridge). This also helps to keep the normal Talk package at a reasonable size as the download of the binaries is around 120 MB.
+
+When this app is used, the basic configuration should work out of the box.
+
+## Use a custom Matterbridge binary
+
+In case you need a non-default binary (currently we ship 32-bit, 64-bit and arm-64 for linux) or want to check a different version of matterbridge, you can also download the matterbridge binary directly from 42wim.
+You then manually set the path for the Matterbridge binary by changing the `matterbridge_binary` spreed app config key:
+```
+occ config:app:set spreed matterbridge_binary --value="/absolute/path/to/binary"
+```
+
+Afterwards the matterbridge version should be shown in the admin settings of Nextcloud Talk, confirming that it works and allowing you to configure it in the individual chats where you are a moderator.

mkdocs.yml

@@ -34,3 +34,4 @@ nav:
   - Commands: 'commands.md'
   - 'PHP events': 'events.md'
   - 'Configuring coTURN': 'TURN.md'
+  - 'Matterbridge integration': 'matterbridge.md'

src/components/AdminSettings/MatterbridgeIntegration.vue

@@ -49,6 +49,8 @@
 		<template v-else>
 			<p class="settings-hint" v-html="description" />
 
+			<p class="settings-hint" v-html="customBinaryText" />
+
 			<p v-if="errorText" class="settings-hint">
 				{{ errorText }}
 			</p>
@@ -111,6 +113,11 @@ export default {
 				return ''
 			}
 		},
+		customBinaryText() {
+			return t('spreed', 'You can also set the path to the Matterbridge binary manually via the config. Check the {linkstart}Matterbridge integration documentation{linkend} for more information.')
+				.replace('{linkstart}', '<a  target="_blank" rel="noreferrer nofollow" class="external" href="https://nextcloud-talk.readthedocs.io/en/latest/matterbridge/">')
+				.replace(/{linkend}/g, ' ↗</a>')
+		},
 	},
 
 	methods: {