Serato 4+¶
Using older Serato versions? See Serato 3.x
Setup¶
- Open Settings from the What's Now Playing icon
- Select Core Settings->Source from the left-hand column
- Select "Serato" from the list of available input sources
- Select Input Sources->Serato from the left-hand column
Configuration¶
TODO: put image here
Local Mode (Recommended)¶
Select Local if What's Now Playing runs on the same computer as Serato:
- Database Status: Shows whether your Serato library was found automatically
- Ignore Deck(s): Check any decks you want to skip (1, 2, 3, 4)
- Mix Mode:
- Newest: Show the most recently started track
- Oldest: Show the longest-playing track
No other setup is required - the plugin finds your Serato library automatically.
Remote Mode¶
Select Remote if What's Now Playing runs on a different computer than Serato:
- In Serato: Enable Live Playlists
- Go to Setup → Expansion Pack tab
- Check "Enable Live Playlists"
-
Click "Start Live Playlist" in the History panel
-
In your web browser: Make the playlist public
- Serato opens your Live Playlist webpage
- Click "Edit Details"
- Change visibility to "Public"
-
Copy the playlist URL
-
In What's Now Playing:
- Paste the URL into the URL field
- Set polling interval (30 seconds is recommended)
Note: Remote mode only provides artist and title information.
Artist Query Configuration¶
The Serato plugin supports artist-based library queries for the !hasartist Twitch chat command and
roulette playlist features.
Query Scope¶
Choose where What's Now Playing searches for artists:
- Entire Library: Searches all tracks in your Serato library
- Selected Playlists/Crates: Searches only specific playlists or crates (comma-separated list)
Multiple Library Support¶
If you have multiple Serato libraries (e.g., separate libraries for different music genres), you can configure additional library paths:
- In the Serato settings, click "Add Library"
- Browse to the additional Serato library directory
- What's Now Playing will search across all configured libraries when querying for artists
This is useful for DJs who organize their music into multiple Serato library databases.
Troubleshooting¶
"No Serato 4+ installation found"¶
- Make sure Serato DJ Pro/Lite 4.0+ is installed
- Run Serato at least once after installation
- Restart What's Now Playing
Tracks not showing up¶
- Make sure tracks are actually playing (not just loaded)
- Check that your crossfader isn't cutting off the track
- Verify your DJ controller is working properly in Serato
Tracks updating slowly¶
- Go to Settings → Quirks
- Enable "Use Polling Observer"
- Set polling interval to 1.0 seconds