-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signal bridge changed, update details
Signed-off-by: Sami Olmari: <[email protected]>
- Loading branch information
Showing
1 changed file
with
12 additions
and
15 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,31 +1,28 @@ | ||
# Matrix<->Signal bridge | ||
|
||
!!! THIS BRIDGE WILL BE REPLACED WITH BETTER/NEWER VERSION IN FEBRUARY 2024 AT THE LATEST !!! | ||
17.2.2024: | ||
!!! THE OLD VERSION OF THIS BRIDGE IS REPLACED WITH BETTER/NEWER VERSION, USERS NEED TO LINK/LOGIN AGAIN !!! | ||
|
||
Up to date info about Mautrix-signal itself: <https://docs.mau.fi/bridges/python/signal/index.html> | ||
Most notable change is that there is no primary device method available in the bridge. | ||
|
||
Up to date info about Mautrix-signal itself: <https://docs.mau.fi/bridges/go/signal/index.html> | ||
|
||
## What? | ||
|
||
An Matrix<->signal bridge for receiving and sending signal messages with Matrix-client, bridging groupchats, puppeting.. At the time of writing still pretty early version, but basic functionality exist and should work, like start chat from matrix, using as primary or linked device (signal stuff), direct messaging and group chats | ||
An Matrix<->Signal bridge for receiving and sending signal messages with Matrix-client, bridging groupchats, puppeting.. Using as linked device (signal stuff), direct messaging and group chats. | ||
|
||
## Set up | ||
|
||
- On matrix: Open chat with `@signalbot:hacklab.fi` | ||
- Issue _either_ | ||
- `link [device name]` to link the bridge as a secondary device | ||
- `register <phone>`to sign into Signal as the primary device, international format. | ||
|
||
### Double puppeting (recommended) | ||
|
||
You can replace the Matrix puppet of your Signal account with your Matrix account. When you do so, messages that you send from other Signal clients will be sent from your Matrix account instead of the default puppet user. | ||
- Issue `login` to link the bridge as a secondary device | ||
- Follow instructions bot tells you | ||
|
||
How to get virgin Access-token: Use <https://gitlab.com/vurpo/matrix-login/> for currently most effortless method. | ||
You can use your Singal app on an phone as your primary device, or run Signal app in Virtual Android, or there is also 3rd alternative: signal-cli, which usage is explained out in [Mautrix-signal wiki](https://docs.mau.fi/bridges/go/signal/authentication.html) | ||
|
||
As with the Signal account login, you must do this in a private chat with the bridge bot. | ||
### Double puppeting | ||
|
||
- Log in with `login-matrix <access token>` | ||
- After logging in, the default Matrix puppet of your Signal account should leave rooms and your account should join all rooms the puppet was in automatically. | ||
For hacklab.fi homeserver users this bridge does double-puppeting automatically. | ||
|
||
## Note | ||
|
||
Info taken and adapted to our use from [Mautrix-signal wiki](https://docs.mau.fi/bridges/python/signal/authentication.html), so in case of info gets outdated, try refer there. | ||
Info taken and adapted to our use from [Mautrix-signal wiki](https://docs.mau.fi/bridges/go/signal/authentication.html), so in case of info gets outdated, try referring there. |