mautrix/docs

Documentation for everything mautrix

mautrix-docs

This repo contains the documentation for all my Matrix software. The intention is to reduce duplication that was present in the old bridge wikis.

The books are built with mdBook. The front page in the bookshelf directory is based on docs.t2bot.io.

docs's Issues

editing reply

If I edit an reply, I get something like that

> !randomnumbers:domain.net @⁨name_of_person⁩ answer * content
in WhattsApp.
And the chatting partner on WA see it also.

Centralized config reference

Is there any centralized reference for the fields in the config shared between bridges?

I've noticed small discrepancies in comments and descriptions between example configs. I'm happy to contribute to standardizing these comments, or working on a single reference page with examples.

openSUSE has gomuks in the main repository

This is RFE for https://docs.mau.fi/gomuks/installation.html:

openSUSE has now gomuks in the main repository (https://build.opensuse.org/package/show/openSUSE:Factory/gomuks), there is no need for special non-standard repositories like mentioned “OpenSUSE (OBS): home:albino:matrix/gomuks”. Every user of openSUSE-based systems can just install using normal means.

The equivalent of /ignore command from IRC?

Could we get an equivalent of the IRC command /IGNORE, please?

https://www.livinginternet.com/r/ra_ignore.htm

And yes, it would be even better if it was time limited (so I can automatically unignore the person after some limited time, so when he stops spouting nonsense on the current discussion thread, he may return again).

How to manually sort/rearrange tags?

The sorting behavior of the tags seem to be very inconsistent and random. It's most definitely not alphabetical or even reverse alphabetical.

I can't order the tags in the way I want them to.

Documentation for Barcelona iOS

However, instructions for Barcelona on iOS are not yet available here.

I get that the developers have an incentive to not make documentation so that they can sell Beeper subscriptions, but would anyone who has gotten it to work (or the developers) mind making documentation?

Potential fix for discord Direct media access

Hey, first thanks for the awesome projects!

I have just implemented a fix for direct media access, it uses Discord_CDN a small JS project, which uses a user token to extract signed links.

Some details here:
aosus/infrastructure-meta#5
aosus/cups-1#53

I originally wanted to submit a PR to add documentation on how to do this, but realistically this program is basic to the point it can be included in the bridge easily.

Pip installing bridge from git uses deprecated method

So apparently the method Mautrix bridges instructs to use to install git head using pip is deprecated and will be phased out at some point. Needs probably changing to whatever the command suggests, I'd assume.

(mautrix-telegram) mautrix-telegram@morpheus:~/mautrix-telegram$ pip install --upgrade git+https://github.com/mautrix/telegram.git#egg=mautrix-telegram[all]
DEPRECATION: git+https://github.com/mautrix/telegram.git#egg=mautrix-telegram[all] contains an egg fragment with a non-PEP 508 name pip 25.0 will enforce this behaviour change. A possible replacement is to use the req @ url syntax, and remove the egg fragment. Discussion can be found at https://github.com/pypa/pip/issues/11617

Sending a message in a signal-group with double-puppeting fails

I have double-puppeting activated and all works fine.
But sometimes after system-upgrade (signald) or if mautrix-bridge stops working, and i restart the bridge, messages to signal-groups are not sent any more.

The behaviour is very strange.

Sending it from my matrix client sends it to mautrix and mautrix to signald. The logs say, all is ok and the message is sent to all members of the group:

Nov 11 10:23:36 sc-chat-01 mautrix-signal[464056]: [2022-11-11 10:23:36,833] [[email protected]] 127.0.0.1 [11/Nov/2022:09:23:36 +0000] "PUT /transactions/40237?access_token=**this is secret**
Pqns2pDcOzeiZL2NITXqsviacV7fb HTTP/1.1" 200 158 "-" "Synapse/1.70.1"
Nov 11 10:23:36 sc-chat-01 mautrix-signal[464056]: [2022-11-11 10:23:36,869] [[email protected]/xJvQc=] Send attempt 0. Attempting to send $yvyPG9Cwytzx1ZaPlu6akgCpHWDGwdenasa
BNdCMU9A with 34223991-0910-4266-bcc9-16bae65c5774
Nov 11 10:23:37 sc-chat-01 mautrix-signal[464056]: [2022-11-11 10:23:37,537] [INFO@mausignald] Successfully sent message to 2/2 users in AGOswhckZZmBGWMRSbXzs9NfaLKS3gUOElL8W/xJvQc= with 0 unregistered failures
Nov 11 10:23:37 sc-chat-01 signald[464021]: 10:23:37.538 [34223991-0910-4266-bcc9-16bae65c5774-send] INFO  send - handled request 34223991-0910-4266-bcc9-16bae65c5774 successfully

I can see the sent message on my native app on my smartphone.
I receive all messages and reactions from them.
But the other members of the signal-group never get my messages or reactions.'

I have to unbridge the room in my matrix-client, and on the next message i get invited again in this room... but a new matrix-room is created. and i have multiple rooms with the same name and only parts of the chat-history...
And i have to do this with ALL signal-group-chats.
Chats with people directly are still working.

Add docker image to docker hub

I would like for you image to be on the docker hub.

Documentation for command arguments is missing

The documentation on command arguments is empty:

https://github.com/mautrix/docs/blob/master/maubot/dev/handlers/commands/arguments.md

Dark theme is very low contrast when JS is not loaded

Without JS:

With JS:

(layout is actually the same, it's just a side-effect of me changing the viewport size between both shots)

Whatsapp room link returning 401

Hello! Thanks for putting all of this together - it's extremely useful. I wanted to engage a bit more with the community so I was trying to joing the whatsapp room with the link listed on this page.

For ease of reading, the link is: https://matrix.to/#/#whatsapp:maunium.net

I'm signed in to my own Synapse server with the Element web client. After going through the various redirects in a browser, I receive the message

#whatsapp:maunium.net is not accessible at this time.

Try again later, or ask a room admin to check if you have access.

M_UNKNOWN was returned while trying to access the room. If you think you're seeing this message in error, please submit a bug report.

Checking the logs shows this request returning a 401.

See logs

        
matrix_1    | 2021-07-31 10:09:59,349 - synapse.http.federation.well_known_resolver - 253 - INFO - GET-11154 - Fetching https://maunium.net/.well-known/matrix/server
matrix_1    | 2021-07-31 10:09:59,487 - synapse.http.federation.well_known_resolver - 190 - INFO - GET-11154 - Response from .well-known: {'m.server': 'federation.mau.chat'}
matrix_1    | 2021-07-31 10:09:59,489 - twisted - 258 - INFO - GET-11154 - b'/etc/resolv.conf' changed, reparsing
matrix_1    | 2021-07-31 10:09:59,490 - twisted - 258 - INFO - GET-11154 - Resolver added ('127.0.0.11', 53) to server list
matrix_1    | 2021-07-31 10:10:01,195 - synapse.http.matrixfederationclient - 598 - INFO - GET-11154 - {GET-O-1} [maunium.net] Got response headers: 401 Unauthorized
matrix_1    | 2021-07-31 10:10:01,195 - synapse.http.matrixfederationclient - 676 - WARNING - GET-11154 - {GET-O-1} [maunium.net] Request failed: GET matrix://maunium.net/_matrix/federation/v1/query/directory?room_alias=%23whatsapp%3Amaunium.net: HttpResponseException('401: Unauthorized')
matrix_1    | 2021-07-31 10:10:01,196 - root - 259 - WARNING - GET-11154 - Error retrieving alias
matrix_1    | 2021-07-31 10:10:01,196 - synapse.http.server - 88 - INFO - GET-11154 -  SynapseError: 502 - Failed to fetch alias
matrix_1    | 2021-07-31 10:10:01,197 - synapse.access.http.8008 - 389 - INFO - GET-11154 - 18.168.47.123 - 8008 - {None} Processed request: 1.852sec/-0.000sec (0.010sec, 0.000sec) (0.000sec/0.000sec/1) 55B 502 "GET /_matrix/client/r0/directory/room/%23whatsapp%3Amaunium.net HTTP/1.1" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:90.0) Gecko/20100101 Firefox/90.0" [0 dbevts]
        
  

I'm pretty new to Matrix - any advice here would be appreciated!

after directives in systemd for bridges

For people who run their bridges on the same server as the homeserver and use postgres, wouldn't it make sense to mention the after directives for postgresql.services and matrix-synapse.services?

message color changes

Hi guys,
I am using the signal bridge on my own matrix server for the purpose of having a unified messenger. It works great, however, some messages sent via signal from other users occur with yellow background and in red font color. I was not able to make out a pattern and have not found any related info in the docs.
Can someone enlighten me? bug, feature or misconfiguration?
thx

signald and hcaptcha (no more recaptcha)

About account registration in signal, it doesn't request recaptcha now but hcaptcha.
Signald has changed their documentation.
https://gitlab.com/signald/signald.org/-/merge_requests/14/diffs

Can't complete iMessage no-sip installation due to jank.crap.studio argo tunnel error 1033

Hi guys,

I'm, following the documentation for the iMessage bridge (no-sip). The URL at https://jank.crap.studio/job/barcelona/job/mautrix/ to download darwin-barcelona-mautrix is not resolving on cloudflare.

Is this hosted anywhere else?

Thanks!

meta-messenger bot username is incorrect

I suspect the username of the bot for Messenger administration is wrong here:

docs/bridges/go/meta/authentication.md

Line 2 in f41ba06

0. Open a private chat with the bridge bot. Usually `@instagrambot:your.server` or `@facebookbot:your.server`

@messengerbot::your.server, might be the correct one.

Security hardening not on Python bridge documentation

Hi, I'm unsure if this is an issue in the documentation per se or a question.

Is there a reason why these hardening lines are only in the Go bridge setup but not on the Python one?

(a) Is this only inherently necessary for Go bridges? (If the answer is yes, then my post is a question)
(b) Would these lines be good to add in the Python bridges too? (if the answer is yes, then my post is an issue in the documentation that could be patched)

Docker-based configuration docs don't include information about exposing the appservice webserver

For (at least) the googlechat bridge, the appservice's own webserver has to be made available to users so that they can authenticate. The Docker-based config docs don't address this aspect at all.

It's not clear to me how 'conditional' sections in those docs work, or I'd have tried to send a PR already... any guidance on how the conditional presentation bits work would be much appreciated.

That command requires you to be logged in problem

Signal bridge bot installed and runs so far. Successfully logged in!
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Successfully generated, registered and stored prekeys! 🎉

Trying to pm the first number and getting the following error:

That command requires you to be logged in

I am logged in as you can see above. Any idea what could be wrong?
mautrix-signal v0.4.99+dev.e33fa956