Deezer Import

The Deezer Import plugin connects to deezer.com using browser automation and imports your Deezer library into Kombiner — including loved tracks and all user-created playlists. It runs on a schedule in the background, keeping your Kombiner library in sync with Deezer continuously.

Configuration

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

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

What Data Is Imported

Deezer’s web player does not surface BPM or key information. Run an enrich plugin after importing to populate those fields.

Authentication Flow

The plugin uses Deezer’s standard email and password login via the web player:

1. The plugin opens deezer.com in a headless browser and navigates to the login page.
2. It fills in your email and password.
3. If Deezer presents a CAPTCHA or any other verification challenge, the plugin calls browser_prompt() — the browser window becomes visible so you can complete it manually.
4. Once authenticated, the session is active and the import begins.

The session persists via cookies for as long as Deezer keeps you signed in (typically several weeks). Scheduled runs after the initial login do not require re-authentication unless the session expires.

Continuous Import Behavior

The plugin uses Kombiner’s cursor system to run efficiently on repeat:

• After each playlist is fully imported, the plugin saves its current track count as a cursor value.
• On subsequent runs, any playlist whose track count has not changed is skipped.
• Only playlists with additions or removals are re-scanned.

After the initial full scan, routine scheduled runs typically complete in seconds.

Playlist Sync

For every Deezer playlist, the plugin creates or updates a matching Kombiner playlist with the same name and track order.

Your loved tracks (the Deezer heart-collection) are imported as a special playlist named “Deezer — Loved Tracks”.

If you rename a playlist in Deezer, the next run creates a new Kombiner playlist with the updated name. The old playlist is not removed automatically.

Tips

• Check your credentials before the first run. You can verify the email and password by logging into deezer.com in a regular browser before configuring the plugin.
• First run takes longer. Deezer’s web player lazy-loads track lists through scrolling. Large loved-tracks collections or long playlists take proportionally longer to scan on the initial run.
• Leave the app open during the first run. Cursors are saved per playlist. If the run is interrupted, the next run resumes from the last saved point.
• Deezer Free and Premium accounts are both supported. The import reads your library through the web player, which is available on all account tiers. Premium features (higher audio quality, offline) are not relevant to the import.
• Playlists are one-way. Kombiner mirrors your Deezer playlists; it does not push changes back to Deezer.

Troubleshooting

Login fails even with the correct password. Deezer sometimes shows a bot-detection challenge. When the plugin calls browser_prompt(), complete any required verification (CAPTCHA, etc.) manually in the browser window, then let the run continue.

The plugin times out on the first run. A very large library can exceed the default 5-minute timeout. Increase the timeout in Settings → Plugins → Deezer Import, then re-run. The cursor tracks progress so no data is lost.

Some playlists are missing. Deezer may load playlists asynchronously. If a playlist does not appear after the first run, simply re-run the plugin — the cursor skips already-imported playlists, so only missing ones are scanned.

Duplicate tracks appear in the library. Each track is keyed by its Deezer track ID. If you see duplicates, check the plugin logs at Settings → Plugins → Deezer Import for any upsert errors that could indicate an ID collision.