Tidal Import
The Tidal Import plugin connects to listen.tidal.com using browser automation and imports your Tidal library into Kombiner — including your favorited tracks (My Collection) and all user-created playlists. It runs on a schedule in the background, keeping Kombiner in sync with your Tidal account automatically.
Configuration
| Setting | Type | Required | Description |
|---|---|---|---|
email | string | Yes | The email address associated with your Tidal account |
password | password | Yes | Your Tidal account password (stored encrypted, never logged) |
Configure the plugin in Settings → Plugins → Tidal Import → Configure.
Note: Your password is stored in Kombiner’s encrypted settings store and is never written to logs or sent anywhere other than Tidal’s own login form.
What Data Is Imported
| Field | Source |
|---|---|
| Title | Track name from Tidal |
| Artist | Primary artist name |
| Duration | Track length in seconds |
| Tidal link | tidal.com/track/… |
Tidal does not expose BPM or key through the web player. To fill in those fields, run an enrich plugin after importing.
Authentication Flow
The plugin uses Tidal’s standard email and password login via the web player:
- The plugin opens
listen.tidal.comin a headless browser. - It enters your email and password into the login form.
- If Tidal requires additional verification (e.g. a CAPTCHA or two-factor confirmation), the plugin calls
browser_prompt()— the browser window becomes visible so you can complete the step manually. - Once authenticated, the session is saved and the import begins.
After a successful login, the browser session remains valid via cookies for as long as Tidal keeps you signed in (typically several weeks). Routine scheduled runs will not require re-authentication unless the session expires.
Continuous Import Behavior
The plugin runs on Kombiner’s import schedule and uses a cursor-based system to avoid redundant work:
- After importing each playlist, the plugin stores the current track count as a cursor value.
- On subsequent runs, playlists whose track count is unchanged are skipped.
- Only playlists with new or removed tracks are re-scanned.
The first run performs a full scan, which may take several minutes for large libraries. All runs after that are incremental and typically finish in seconds.
Playlist Sync
For every Tidal playlist, the plugin creates or updates a matching Kombiner playlist with the same name and track order.
Your favorited tracks (My Collection) are imported as a special playlist named “Tidal — My Collection”.
If you rename a playlist in Tidal, the next run creates a new Kombiner playlist with the updated name. The old playlist is not deleted automatically.
Tips
- Verify your login credentials before the first run. A typo in the email or password will cause the plugin to fail immediately. You can test your credentials by logging into
listen.tidal.comdirectly in a browser. - First run takes longer. Tidal’s web player requires scrolling to load all tracks in a collection. Large libraries can take several minutes on the initial run.
- Leave the app open during the first run. Cursors are saved at the playlist level, so a mid-run interruption means the next run will only re-scan incomplete playlists.
- Tidal HiFi and HiFi Plus accounts are supported. The import plugin works the same regardless of subscription tier — it reads your library through the web player interface.
- Playlists are one-way. Kombiner mirrors your Tidal playlists but does not push changes back to Tidal.
Troubleshooting
Login fails even with the correct password.
Tidal may show a CAPTCHA or 2FA prompt that the headless browser cannot complete on its own. When the plugin calls browser_prompt(), you will see the browser window — complete any manual verification step and the plugin will continue from there.
The plugin times out on the first run. Very large libraries (thousands of tracks across many playlists) can exceed the default 5-minute timeout. You can increase the timeout in Settings → Plugins → Tidal Import. The cursor ensures no work is lost — just re-run after adjusting the timeout.
Some tracks show no album. A small number of Tidal tracks (singles, certain regional releases) have no album associated in the web player. This is expected and those fields will remain empty until an enrich plugin fills them in.
Duplicate tracks appear in the library. Each track is keyed by its Tidal track ID. If duplicates appear, check the plugin logs at Settings → Plugins → Tidal Import for any upsert errors.