Connect Touchless to your apps

Discord, by hand and by voice.

Control your own Discord — mute, deafen, switch voice channels — through Touchless gestures and voice commands. One-minute setup, then it just works. Your Discord password stays on Discord's site; Touchless only ever sees a public app ID and a token.

✓ Runs locally ✓ No subscription ✓ No middle-man server ✓ Local IPC, not cloud

Spotify ● Available now Apple Music Coming soon

Discord ● Setup below

The fastest path — use the in-app wizard

In Touchless: Settings → General → Discord → Set up your own Discord app. Three short screens, the redirect URI has a Copy button, you'll be done in about a minute. The instructions below mirror the wizard if you'd rather follow them on the web.

Why "your own app"? Discord restricts the desktop RPC scope to the OWNER of the registered Developer app — so every Touchless user becomes the owner of their own free Discord app. That removes the gating entirely. Your Discord account stays your account; Touchless only exchanges a public Application ID and a per-session token.

Step-by-step

Open the Discord Developer Portal

Sign in with the same Discord account you use to chat. Free for everyone — no payment, no waitlist, no review. If a "What brings you to the Developer Portal?" survey pops up, click Skip at the bottom — none of the options apply.

Open Developer Portal →

Create a new application

Top-right, click New Application. Name it whatever you like — "Touchless Personal" is a perfectly fine choice. Accept the Terms of Service. Click Create. You'll land on the new app's General Information page.

Add the redirect URI

Left sidebar → OAuth2. Scroll to Redirects → click Add Another. Paste this single value:

http://127.0.0.1

Click Save Changes at the bottom of the page.

Why this URI? Discord's RPC auth doesn't actually redirect your browser to this address — the OAuth code comes back via a local pipe. But the token-exchange step still validates the URI against the list you register here, so it has to be exact.

Copy your Application ID

Still on the OAuth2 page, find Client Information at the top. Click the small Copy button next to Client ID (also called Application ID — Discord uses both names interchangeably). It's an 18-19 digit number like 1505345698126630972.

Reset and copy the Client Secret

Right below the Application ID, find Client Secret. Click Reset Secret → confirm with Yes, do it!. Discord generates a fresh ~32-character alphanumeric secret and shows it once — click the Copy button immediately.

Lost it? No problem. Click Reset Secret again — Discord will give you a new one. The old one stops working as soon as you reset, so don't reset until you're ready to paste.

Paste both into Touchless

Back in Touchless: Settings → General → Discord → Set up your own Discord app. Walk to the last page, paste your Application ID and Client Secret into the two fields, click Finish. Then click Connect Discord — the Discord desktop client pops up an Authorize modal, you click Authorize, and you're done. Voice commands like "mute discord" and gestures like left-hand-three → right-fist now control your Discord.

Troubleshooting

"discord client not running (no IPC pipe found)"

The Discord desktop client has to be running for Touchless to talk to it — the browser version doesn't expose the IPC pipe. Open the Discord desktop app and try again.

Token endpoint HTTP 401 / "invalid_client"

Your Application ID or Client Secret was wrong, or the secret was reset on the Discord side after you pasted it. Re-open the wizard, click Reset Secret on the Discord page once more, and copy the freshly-shown value into Touchless immediately.

"redirect_uri_mismatch"

You missed Step 3 or typed the redirect URI with a typo. Edit your Discord app, go to OAuth2 → Redirects, and verify there's an entry exactly matching http://127.0.0.1 (no port, no trailing path). Click Save Changes.

Authorize prompt opens then nothing happens

Either you closed the prompt without clicking Authorize, or the IPC pipe was busy. Quit Discord completely (from the system tray), re-open it, then click Connect Discord again.

Still stuck

Email [email protected] with the [discord-auth] lines from the terminal (if running from source) or from your Touchless log folder (packaged build).

FAQ

Is this safe?

Yes. Your Discord password is only entered on Discord's official site. The Client Secret is sensitive but it stays on your machine — Touchless writes it to a local config file and never sends it to any server except Discord's own OAuth endpoint. Tokens are also stored locally.

Does this cost anything?

No. Discord's developer program is free for personal use.

Can I revoke access later?

Yes. Sign in to discord.com/settings/authorized-apps and click the X next to your app. Or delete the app entirely from the Developer Portal.

Why do I need to create my own Discord app?

Discord restricts the rpc OAuth scope to the OWNER of the registered Developer app. Public-distribution approval is a one-time review process that Discord has been winding down — new approvals are rare. The per-user-own-app pattern sidesteps the review queue entirely: you're the owner of your own free app, so the scope works for you on day one. Same trick as the Spotify setup wizard, different reason.