Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation? #36

Open
uhlhosting opened this issue Feb 23, 2021 · 16 comments
Open

Documentation? #36

uhlhosting opened this issue Feb 23, 2021 · 16 comments
Labels
1. to develop Accepted and waiting to be taken care of enhancement New feature or request

Comments

@uhlhosting
Copy link

It seems that to install the app via Web app was simple, now if someone explain me where to find the rest of steps to get the integration working would be great.

It seems whoever documented this README.md here does not care about the install procedure, more about the development procedure. Is this in Beta? Should not be used? What am I missing. What is the benefit of installing this and not the Matterbridge itself via cli? Where do configs go in Matterbridge from the web app?

@gary-kim
Copy link
Member

All the configuration happens in the Nextcloud Talk settings. If you'd like to add that to the README, feel free to make a PR.

@uhlhosting
Copy link
Author

Well, thats the issue that I see nothing there to configure related to mattermost or matterbridge.

@sirdrakeistda
Copy link

I searched the config too. Some bridges (e.g WhatsApp) are not configurable in the Talk frontend, so I wanted to add it manually. But I haven't found the config file. Is it possible to add bridges without frontend?

@gary-kim
Copy link
Member

Feel free to use Matterbridge directly to have full control over the config file. The purpose of the integration with Talk is to let people who are unfamiliar with config files and managing services easily set up bridging between their Nextcloud Talk instances and other chat systems.

@uhlhosting
Copy link
Author

I agree with you, yet you seem to completely ignore the fact that there are no such options no where inside talk settings nor the plugin settings.

@gary-kim
Copy link
Member

image
image

@sirdrakeistda
Copy link

sirdrakeistda commented Mar 1, 2021

Feel free to use Matterbridge directly to have full control over the config file. The purpose of the integration with Talk is to let people who are unfamiliar with config files and managing services easily set up bridging between their Nextcloud Talk instances and other chat systems.

Where do I find the config files of Matterbridge to configure them manually. I haven't found them. I looked in every ".toml" file on my NC and I looked also in the spreed and talk_matterbridge folder. But I haven't found any config except for temporary files in /tmp.

I know the web config, but I want to configure more options.

@gary-kim
Copy link
Member

gary-kim commented Mar 8, 2021

To use Matterbridge directly, refer to the Matterbridge documentation: https://github.com/42wim/matterbridge#running and https://github.com/42wim/matterbridge/wiki/How-to-create-your-config

Nextcloud Talk support was added to Matterbridge recently so that can be used: https://github.com/42wim/matterbridge/wiki/Section-Nextcloud-Talk-%28basic%29

@gary-kim
Copy link
Member

gary-kim commented Mar 8, 2021

All in all, let's keep this issue open. If someone wants to make a PR that adds more detailed documentation to the README to avoid further misunderstanding, that would be very much appreciated.

@gary-kim gary-kim added 1. to develop Accepted and waiting to be taken care of enhancement New feature or request labels May 27, 2021
@Mannshoch
Copy link

I read links but also still do not understand where to set up this toml files. Could someone tell me where to place it in Nextcloud?

@sirdrakeistda
Copy link

@Mannshoch finding the .toml files wont help you really. They are in the /tmp folder and only temporally saved. I haven't found a way to add bridges without the frontend and without editing php. You could try to override .toml files in /tmp, but I think there is at the moment no good solution.

@Mannshoch
Copy link

I searched again now I finaly found a blog that. Said how to configure Matterbridge. I newer had the Idea to look into Talk in the right Panel. Sorry for this misunderstanding.

@Mannshoch
Copy link

Hm.. Seems I missunderstood more. I assumed I could set-up my accounts in my profile and automatic get all teams/channels I have eg. on Mattermost with a representative into talk and may get access to the contact list.
Not sure if I could use Matterbridge that way.

@sirdrakeistda
Copy link

You wont get the contact list. Matterbridge only bridges messages between messenger. Getting messages from teams should work.

@JaneIsContributing
Copy link

@nickvergessen Should the documentation be in this repository here, or in the actual Nextcloud Talk documentation over at https://nextcloud-talk.readthedocs.io/en/latest/matterbridge/ extending the already existing base page?

@nickvergessen
Copy link
Member

I guess it makes sense to put it there, yes.
And then link to it from the Readme of this repo and description of the app in info.xml?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
1. to develop Accepted and waiting to be taken care of enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

6 participants