Merge pull request #2222 from array-in-a-matrix/master
Document login to Discord using token
This commit is contained in:
commit
fa11d5af2b
@ -11,13 +11,10 @@ See the project's [documentation](https://docs.mau.fi/bridges/go/discord/index.h
|
|||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
For using this bridge, you would need to authenticate by **scanning a QR code** with the Discord app on your phone **or** by using **discord account token**.
|
There are 2 ways to login to discord using this bridge, either by [scanning a QR code](#method-1-login-using-qr-code-recommended) using the Discord mobile app **or** by using a [Discord token](#method-2-login-using-discord-token-not-recommended).
|
||||||
|
|
||||||
You can delete the Discord app after the authentication process.
|
|
||||||
|
|
||||||
If this is a dealbreaker for you, consider using one of the other Discord bridges supported by the playbook: [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-discord.md) or [matrix-appservice-discord](configuring-playbook-bridge-appservice-discord.md). These come with their own complexity and limitations, however, so we recommend that you proceed with this one if possible.
|
If this is a dealbreaker for you, consider using one of the other Discord bridges supported by the playbook: [mx-puppet-discord](configuring-playbook-bridge-mx-puppet-discord.md) or [matrix-appservice-discord](configuring-playbook-bridge-appservice-discord.md). These come with their own complexity and limitations, however, so we recommend that you proceed with this one if possible.
|
||||||
|
|
||||||
|
|
||||||
## Installing
|
## Installing
|
||||||
|
|
||||||
To enable the bridge, add this to your `vars.yml` file:
|
To enable the bridge, add this to your `vars.yml` file:
|
||||||
@ -68,6 +65,20 @@ When using this method, **each user** that wishes to enable Double Puppeting nee
|
|||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
|
### Logging in
|
||||||
|
|
||||||
|
#### Method 1: Login using QR code (recommended)
|
||||||
|
|
||||||
|
For using this bridge, you would need to authenticate by **scanning a QR code** with the Discord app on your phone.
|
||||||
|
|
||||||
|
You can delete the Discord app after the authentication process.
|
||||||
|
|
||||||
|
#### Method 2: Login using Discord token (not recommended)
|
||||||
|
|
||||||
|
To acquire the token, open Discord in a private browser window. Then open the developer settings (keyboard shortcut might be "ctrl+shift+i" or by pressing "F12"). Navigate to the "Network" tab then reload the page. In the URL filter or search bar type "/api" and find the response with the file name of "library". Under the request headers you should find a variable called "Authorization", this is the token to your Discord account. After copying the token, you can close the browser window.
|
||||||
|
|
||||||
|
### Bridging
|
||||||
|
|
||||||
1. Start a chat with `@discordbot:YOUR_DOMAIN` (where `YOUR_DOMAIN` is your base domain, not the `matrix.` domain).
|
1. Start a chat with `@discordbot:YOUR_DOMAIN` (where `YOUR_DOMAIN` is your base domain, not the `matrix.` domain).
|
||||||
2. If you would like to login to Discord using a token, send `login-token` command, otherwise, send `login-qr` command.
|
2. If you would like to login to Discord using a token, send `login-token` command, otherwise, send `login-qr` command.
|
||||||
3. You'll see a QR code which you need to scan with the Discord app on your phone. You can scan it with the camera app too, which will open Discord, which will then instruct you to scan it a 2nd time in the Discord app.
|
3. You'll see a QR code which you need to scan with the Discord app on your phone. You can scan it with the camera app too, which will open Discord, which will then instruct you to scan it a 2nd time in the Discord app.
|
||||||
|
Loading…
Reference in New Issue
Block a user