Spotify Import

The Spotify Import plugin connects to open.spotify.com using browser automation and imports your entire Spotify library into Kombiner — including liked songs (My Library) and all user-created playlists. It runs on a schedule in the background, keeping your Kombiner library in sync with Spotify without any manual intervention.

Configuration

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

What Data Is Imported

Spotify does not expose BPM, key, or genre through the web player interface. To enrich your Spotify tracks with that data, run an enrich plugin such as Beatport Enrich after importing.

Authentication Flow

Spotify Import uses a passwordless email login — no password is required or stored.

1. On first run, the plugin navigates to open.spotify.com and enters your email address.
2. Spotify sends a magic link to that email address.
3. Because no one can click the link automatically, the plugin calls browser_prompt() — the browser window becomes visible, prompting you to open your email, and enter 6-digit code to complete the login.
4. Once you are logged in, the browser session is active and the import begins.

Note: The code expires in a few minutes. When prompted, switch to your email client and enter the code. If you miss it, simply re-run the plugin — it will request a new one.

After the initial login, the browser session persists via cookies for as long as Spotify keeps you signed in (typically several weeks), so you will not be prompted again on routine scheduled runs.

Continuous Import Behavior

The plugin runs on Kombiner’s import schedule and is designed to be efficient on repeat runs:

• Each playlist’s track count is stored as a cursor value after a successful import.
• On the next run, if a playlist’s current track count matches the stored value, it is skipped entirely.
• Only playlists with new or removed tracks are re-scanned.

This means that after the first (full) run, subsequent scheduled runs typically complete in seconds unless you have added new music to Spotify.

Playlist Sync

For every Spotify playlist, the plugin creates or updates a matching Kombiner playlist with the same name. Tracks are linked to the playlist in the same order they appear in Spotify.

The liked songs collection (My Library) is imported as a special playlist named “Spotify — Liked Songs”.

If you rename a playlist in Spotify, the next run will create a new Kombiner playlist with the new name. The old playlist remains in Kombiner and can be deleted manually.

Tips

• Use the correct email address. The email must match the account you log into Spotify with. If you normally sign in via Google or Facebook, check which email Spotify has on file under Account → Edit Profile.
• First run takes longer. The initial import needs to scroll through every playlist to collect all tracks. Large libraries (thousands of tracks across many playlists) can take several minutes. Subsequent runs are much faster.
• Leave the app open during the first run. If Kombiner is closed mid-import, the cursor saves progress at the playlist level, so the next run will re-scan any playlist that wasn’t fully completed.
• Playlists are one-way. Kombiner reflects your Spotify playlists; it does not push changes back to Spotify.

Troubleshooting

The plugin gets stuck at the login screen. Spotify’s web player occasionally shows a CAPTCHA or extra verification step. If the plugin does not proceed automatically, use the browser_prompt() interaction to complete any manual step, then let the plugin continue.

I’m not receiving the 6-digit code email. Check your spam folder. Spotify’s login emails sometimes land there. If the email never arrives, verify that the email address in the plugin settings matches your Spotify account exactly.

Tracks are imported but playlists are not. This can happen if the plugin times out before scanning all playlists on the first run. Re-run the plugin — it will resume from the last saved cursor position and pick up the remaining playlists.

Duplicate tracks appear in the library. Each track is identified by its Spotify track ID. Duplicates should not appear under normal conditions. If you see them, check Settings → Plugins → Spotify Import logs for any upsert errors.