Skip to content

troubleshooting

Jump to bottom
github-actions[bot] edited this page May 16, 2026 · 1 revision

Troubleshooting

Spotify

"Spotify Client ID not configured"

Open Project → Service Settings… and enter your Client ID. See Connecting Streaming Services → Spotify for instructions on creating a Developer App.

The browser opens but auth never completes

Make sure the Redirect URI in your Spotify Developer App settings is exactly:

http://127.0.0.1:8888/callback

No trailing slash, no https, no different port.

"Authentication failed"

Try clearing the cached token:

  1. Delete ~/Library/Caches/rekordbox_set_list_manager/.spotify_cache (macOS) or the equivalent on your platform.
  2. Restart Rekordbox Set List Manager and try connecting again.

Tidal

The device-code URL is not shown in the dialog

Check the terminal window where you launched Rekordbox Set List Manager — the URL is always printed to stdout. Copy it and open it in a browser.

"Authentication was not completed"

The device-code login has a time limit (~5 minutes). If it expires, click Connect to Tidal again.

Session expired on relaunch

Tidal sessions last several months. If yours has expired, click Connect to Tidal again to authenticate. You can also clear the session manually from Project → Service Settings… → Clear Cached Tidal Session.

Rekordbox collection

"master.db not found" / auto-detection fails

Rekordbox Set List Manager looks for the database at ~/Library/Pioneer/rekordbox/master.db. If Rekordbox is installed in a non-standard location, the database may not be at that path.

Workaround: Export your library from Rekordbox as XML (File → Export Playlist in XML Format) and load the XML via the Import dialog's Browse button instead.

All tracks unmatched after import

Check the following:

  1. The Rekordbox collection was loaded (the import dialog shows a track count > 0 in the Collection section).
  2. Your streaming tracks have ISRCs — check the Match Info panel. Without ISRCs, the engine falls back to fuzzy matching, which requires reasonable artist/title data.
  3. The local files in your Rekordbox library have their metadata correctly filled in (artist + title).

Wrong track matched

Right-click the track → Fix Match… and manually select the correct local file.

Projects

"Unexpected file extension" on open

Rekordbox Set List Manager expects .setmgr files. If the file was renamed, change the extension back to .setmgr.

Autosave restore prompt on launch

Rekordbox Set List Manager found an autosave file newer than the saved project (usually from a previous crash). Click Restore to recover your work, or Discard to ignore it and open the last manually saved version.

Performance

The app is slow with large collections

The Rekordbox database reader loads the full collection into memory on first use. Libraries with 50,000+ tracks can take a few seconds to load. Once loaded, the collection is kept in memory for the session.

Import takes a long time

Fetching all tracks in a large playlist (1,000+ tracks) involves multiple API calls and may take up to a minute. A progress bar is shown in the Import dialog.

General

The window is blank / does not render correctly

Rekordbox Set List Manager uses PySide6 (Qt 6). On some Linux configurations, Wayland or GPU compositing can cause rendering issues. Try launching with:

QT_QPA_PLATFORM=xcb uv run set-manager

Reporting a bug

Please open an issue on the project's GitHub repository. Include:

  • Your operating system and version
  • The Rekordbox Set List Manager version (rslm --version)
  • Steps to reproduce the problem
  • Any error messages from the terminal

Clone this wiki locally