Logging in
- Open a private chat with the bridge bot. Usually
@hangoutsbot:your.server.
- Send
login.
- Open the link sent by the bot and follow the instructions.
- Automatic login may not work. If it does not, reload the page and select the "Manual login" checkbox before starting. Manual login involves logging into your Google account normally and then manually getting the OAuth token from browser cookies with developer tools.
- Recent chats should now get portals automatically. Other chats will get portals as you receive messages.
Double puppeting
N.B. Currently only users on the same homeserver as the bridge can log in with their Matrix account.
You can replace the Matrix puppet of your Hangouts account with your Matrix account. When you do so, messages that you send from other Hangouts clients will be sent from your Matrix account instead of the default puppet user.
Also, until matrix-org/synapse#2954 is fixed, it is the only way to enable bridging of ephemeral events, such as presence, typing notifications and read receipts.
As with the Hangouts account login, you must do this in a private chat with the bridge bot.
- Log in on the homeserver to get an access token, for example with the command
curl -XPOST -d '{"type":"m.login.password","user":"example","password":"wordpass","initial_device_display_name":"mautrix-hangouts"}' "https://example.com/_matrix/client/r0/login"
- If not already, use
login to log into hangouts (see previous section)
- Send
login-matrix <access token> to the bridge bot
- After logging in, the default Matrix puppet of your Hangouts account should leave rooms and your account should join all rooms the puppet was in automatically.