SoundCloud Import

The SoundCloud Import plugin connects to soundcloud.com using browser automation and imports your liked tracks into Kombiner. It runs on a schedule in the background, keeping your Kombiner library up to date as you like new tracks on SoundCloud.

Configuration

Configure the plugin in Settings → Plugins → SoundCloud Import → Configure.

Note: Your password is stored in Kombiner’s encrypted settings store and is never written to logs or sent anywhere other than SoundCloud’s own login form.

What Data Is Imported

SoundCloud does not expose BPM or key data. Run an enrich plugin after importing to populate those fields.

Authentication Flow

The plugin uses SoundCloud’s standard email and password login:

1. The plugin opens soundcloud.com in a headless browser and navigates to the sign-in page.
2. It enters your email and password.
3. If SoundCloud requires additional verification (CAPTCHA, 2FA, or any other challenge), the plugin calls browser_prompt() — the browser window becomes visible so you can complete the step manually.
4. Once authenticated, the session is active and the import begins.

The session persists via cookies for the duration of SoundCloud’s session lifetime. Scheduled runs after the initial login do not require re-authentication unless the session expires or you change your password.

Continuous Import Behavior

The plugin runs on Kombiner’s import schedule and uses cursors to avoid re-importing unchanged data:

• After each successful run, the plugin stores the total liked track count as a cursor value.
• On the next run, if the count is the same, the run completes immediately without scanning.
• If the count has increased (new likes), the plugin scrolls through the likes list and imports the newly added tracks.

After the initial full scan, routine scheduled runs are very fast for most users.

Note: SoundCloud’s likes list is ordered newest-first and uses infinite scroll. The plugin collects tracks by scrolling until it reaches previously seen content (identified by track ID). If you un-like a large number of tracks, the plugin may need to do a fuller scan on the next run to reconcile the difference.

Tips

• Verify credentials before the first run. Log into soundcloud.com in a normal browser window to confirm your email and password are correct before entering them into the plugin settings.
• First run takes longer. SoundCloud loads likes through infinite scroll. Users with thousands of liked tracks can expect the first import to take several minutes.
• Album fields will be empty. This is expected behavior — SoundCloud is a creator-upload platform without structured album releases. Use enrich plugins to look up album information based on title and artist if needed.
• SoundCloud Go+ is not required. The import plugin reads your public likes list, which is available on free accounts.

Troubleshooting

Login fails even with the correct password. SoundCloud occasionally presents a CAPTCHA or rate-limit challenge to automated browsers. When browser_prompt() is called, the browser window will appear — complete any challenge manually and the run will continue.

The plugin stops partway through a large likes list. The default 5-minute timeout may be too short for very large collections on the first run. Increase the timeout in Settings → Plugins → SoundCloud Import and re-run. The cursor tracks the last successfully imported track ID, so the next run will resume rather than start over.

Some liked tracks are missing from Kombiner. SoundCloud occasionally removes tracks from the platform (takedowns, deleted accounts). These tracks will not be accessible through the web player and cannot be imported. The plugin skips them and logs a warning.

I see the artist name but the track title looks wrong. SoundCloud creators sometimes include extra information (remix tags, labels, release years) directly in the track title. The plugin imports the title exactly as it appears on SoundCloud. You can edit the track manually in Kombiner after import.