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. Four 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 two 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
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.
4
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.

Optional

Not part of setup — only if someone else will use the application you just made.

Letting someone else use your application (App Testers)

You don't need this for yourself. You created the application, so Discord already lets your own account authorize it — there is nothing to accept and no invite to send.

It only matters if you hand your Client ID and Client Secret to someone else — a second PC signed in as a different Discord account, or a friend you're setting up. Discord won't show them the authorization window until you add them:

  • Open your application in the Developer Portal and click App Testers in the left sidebar.
  • Click Add Tester, type their Discord username, and confirm.
  • They open Discord and accept the invite. It has to read Accepted, not Pending.

Simpler alternative: have them follow this guide and create their own application. It takes the same five minutes and nobody has to share a Client Secret.

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're using someone else's Client ID and Secret and they haven't added you under App Testers — see Letting someone else use your application above. (If you made the application yourself, this can't be the cause.)
  • 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 authorization didn't cover everything Deckord needs — usually because it was granted once on an older version and Discord reused it. Open AUTHORIZED ACCOUNTS in the settings panel, remove the account, and click Authorize Discord again, approving the window that appears.