Connect Touchless to your apps

Spotify, by hand and by voice.

Control your own Spotify playback through Touchless gestures and voice commands. One-minute setup, then it just works. Your Spotify password stays on Spotify's site — Touchless only ever sees a public ID.

✓ Runs locally ✓ Open source ✓ No subscription ✓ PKCE OAuth, no shared secrets

Spotify ● Available now

Apple Music Coming soon Discord Coming soon

The fastest path — use the in-app wizard

In Touchless: Settings → General → Spotify → Set up your own Spotify app. Three short screens, each value 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.

Your Spotify password never leaves Spotify. Touchless only receives a public Client ID — a public identifier Spotify gives you when you create an app. It's not a secret and doesn't grant access to your account.

Step-by-step

Open the Spotify Developer Dashboard

Sign in with the same Spotify account you use to listen to music. Free for everyone — no payment, no waitlist, no review.

Open Create-App page →

Not signed in yet? The link above takes you to Spotify for Developers. If you see the marketing page (purple background with floating shapes) instead of a Create-App form: click the ≡ menu in the top-right corner → Log in → Dashboard → Create app.

Fill in the basics

Type any name you like for your app — these are just suggestions:

App nameTouchless Personal

DescriptionPersonal Spotify control via Touchless

Websitehttps://touchless-control.pages.dev/

Add the callback URLs

Spotify sends your browser to one of these local addresses after you sign in. Touchless tries ports 5000 → 5004 in order so a busy 5000 (Discord, OBS, dev servers) doesn't block you — registering all five is recommended. At minimum, register 5000. Click Add in the Dashboard after each line:

http://127.0.0.1:5000/callback

http://127.0.0.1:5001/callback

http://127.0.0.1:5002/callback

http://127.0.0.1:5003/callback

http://127.0.0.1:5004/callback

Select Web API

Under "Which API/SDKs are you planning to use?", check the box next to Web API. Don't tick any of the others — Touchless only uses the Web API to send playback commands (play, pause, skip, volume) to your Spotify account.

App type: Desktop App. Commercial application: No.

Copy your Client ID

Click Save. Spotify opens your new app's page with a Client ID at the top — a 32-character hex string like 7763a7c443604776b0060da01428686f. Click the copy icon next to it.

Paste into Touchless

Back in Touchless: Settings → General → Spotify → Set up your own Spotify app. Walk to the last page, paste your Client ID, click Finish. Then click Connect Spotify — your browser opens to Spotify's authorize page, you click Agree, and you're done. Voice commands like "play Sade on Spotify" and gestures like right-hand fist now control your Spotify account.

Troubleshooting

INVALID_CLIENT: Invalid redirect URI

You missed one of the five callback URLs in step 3. Re-open your app in the Spotify Dashboard, edit, add the missing ones, save.

user_not_listed

You're still using Touchless's bundled Client ID. Either you skipped this wizard, or your saved Client ID was empty / wrong. Re-run the Set up wizard.

"spotify auth port busy"

Every callback port 5000–5004 is in use by another app. Close Discord, OBS, or any local dev server, then click Connect Spotify again.

Authorization opens then nothing happens

The local callback server timed out after 3 minutes. Either Spotify's authorize page didn't load, or you closed the browser tab. Click Connect Spotify again.

Still stuck

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

FAQ

Is this safe?

Yes. Your Spotify password is entered only on Spotify's official site. Touchless uses PKCE OAuth — no client secret is shared. The Client ID is public per Spotify's docs. Tokens are stored locally on your PC.

Does this cost anything?

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

Can I revoke access later?

Yes. Sign in to spotify.com/account/apps and click Remove next to your app. Or delete the app entirely from the Developer Dashboard.

Why do I need to create my own Spotify app?

Spotify caps shared developer apps at 5 testers and removed the indie-friendly extension program in 2024. The remaining path requires 250 000 monthly users plus a registered business. Each Touchless user creating their own app keeps Spotify's policies happy and removes the cap entirely — you become the sole user of your own app.