Connect Your Account

Go to Settings, find SoundCloud under Connected Accounts, and click Connect. SoundCloud opens in a new window and asks you to approve the connection. That is the whole setup.

Your beats upload to your own SoundCloud account, and you can disconnect at any time from the same screen.

Using Your Own SoundCloud App

This is optional. BeatOps connects using its own registered SoundCloud app, so most people never need this. Set up your own app if you would rather have your uploads run through your own SoundCloud application, or keep the sign-in entirely on your machine.

Registering an app on SoundCloud requires a SoundCloud Artist Pro subscription. That is SoundCloud's rule, not ours, and it is the reason BeatOps does not ask you for credentials by default.

  1. Log in to SoundCloud
    Go to soundcloud.com and log in to your account.
  2. Register your application
    Go to soundcloud.com/you/apps and click "Register a new application".
  3. Fill in application details
    Enter an app name (e.g., "BeatOps Uploader"). Fill in the description and accept the terms.
  4. Set redirect URI
    Set the redirect URI to: http://localhost:7410/api/soundcloud/callback
  5. Copy your credentials
    After registration, copy your Client ID and Client Secret.
  6. Enter in BeatOps
    Go to Settings > API Keys > SoundCloud API Credentials and paste your Client ID (App ID) and Client Secret (App Secret).
  7. Connect your account
    Click "Connect" next to SoundCloud and authorize the connection. BeatOps now uses your app instead of ours.

Troubleshooting

The SoundCloud page is blank

This almost always means the redirect URI does not match. It only applies if you registered your own app: check that its settings contain http://localhost:7410/api/soundcloud/callback exactly, with http (not https), port 7410, and no trailing slash. SoundCloud shows a blank page instead of an error when this is wrong.

"Cannot reach BeatOps to start the SoundCloud connection"

Connecting with the BeatOps app needs an internet connection to our server. Check your connection and try again. If you registered your own app, connecting does not depend on our server at all.

Token expired

SoundCloud tokens are refreshed automatically, so you should never need to reconnect for this. If you see persistent errors, disconnect and reconnect your account.

Privacy

When you connect with the BeatOps app, the sign-in exchange goes through our server, because SoundCloud requires an application secret for it and that secret cannot live inside a downloaded app. We do not store or log your SoundCloud tokens: they are passed straight back to your machine, where they are stored encrypted. Your SoundCloud password is never involved, since you sign in on SoundCloud's own site.

If you register your own app, your credentials and tokens stay encrypted on your computer and none of this touches our server.