Deckord Setup Guide
Stream Deck & Stream Deck + ready

Connect Deckord to Discord

Discord requires every app that controls it to register itself once. You'll create a free entry in Discord's settings, copy two values from it, and paste them into Stream Deck. Five steps, and you never do it again.

⏱ About 5 minutes 🔁 One-time setup

Before you start

Most setup problems come from one of these being missing.

✓

Discord desktop app, open and logged in

Deckord controls the app running on your PC. Discord in a browser tab will not work.

✓

Deckord installed

Installed from the Elgato Marketplace. It appears in the Stream Deck actions list on the right.

Setup

1
Create a Discord application

Open the link below and sign in with the Discord account you normally use.

Open the Discord Developer Portal ↗
  1. Click New Application in the top-right corner.
  2. Name it Deckord, agree to the terms, then click Create.
Keep this tab open You'll use it for the next three steps.
2
Add the redirect URL
  1. Click OAuth2 in the left sidebar.
  2. Under Redirects, click Add Redirect and paste the address below.
  3. Scroll down and click the green Save Changes button.
http://localhost:57116
Must match exactly Use the Copy button rather than typing it. https instead of http, a missing :57116, or a trailing slash will all cause an Invalid OAuth2 redirect_uri error later.
3
Add yourself as an App Tester

Discord only grants the permissions Deckord needs to accounts listed here — including your own.

  1. Click App Testers in the left sidebar.
  2. Click Add Tester, type your own Discord username, and confirm.
  3. If it shows as Pending, open Discord and accept the invite it sends you.
Don't skip this If your account isn't Accepted here, the authorization window in step 5 never appears.
4
Copy your Client ID and Secret
  1. Go back to OAuth2 in the left sidebar.
  2. Click Copy under Client ID.
  3. Under Client Secret, click Reset Secret if none is shown, then Copy.
Treat the secret like a password Discord shows it only once, so copy it now. Never share it in a screenshot or message.
5
Connect in Stream Deck

Make sure Discord is running, then switch to the Stream Deck app.

  1. Drag any Deckord action — Mute is a good first one — onto an empty key.
  2. In the settings panel below, expand DISCORD CONNECTION.
  3. Paste your Client ID and Client Secret into the two fields.
  4. Click Authorize Discord, then click Authorize in the Discord window that pops up.
Done Your Discord name and avatar replace Disconnected at the top of the panel. Press the key — your mic mutes. Every other Deckord key and dial you add from now on is already connected.

If something doesn't work

The Authorize window never appeared
  • The Discord desktop app isn't running. Open it, log in, and click Authorize Discord again.
  • You aren't accepted under App Testers. Recheck step 3.
  • The window opened behind another window — check your taskbar.
  • Discord is running as administrator and Stream Deck isn't, or vice versa. Run both the same way.
"Invalid OAuth2 redirect_uri"
The redirect saved in Discord doesn't match. It must be exactly http://localhost:57116 — no https, no missing port, no trailing slash. Fix it and click Save Changes at the bottom of the Discord page, which is easy to miss.
It says the client is invalid
Your Client ID or Secret was pasted wrong, or the secret was reset afterwards. Re-copy both with the Copy buttons in the Developer Portal, check no extra spaces came along, and paste them in again.
Keys show "Disconnected" after restarting my PC
Discord probably started more slowly than Stream Deck. Wait for Discord to finish loading, then press any Deckord key to reconnect.
Mute works, but channels and messages are empty
The tester invite likely wasn't accepted when you authorized. Confirm step 3, then open AUTHORIZED ACCOUNTS in the settings panel, remove the account, and click Authorize Discord again.