Importing tracklists & playlists

A tracklist is a batch capture: a Spotify or Apple Music playlist, a tracklist page (1001tracklists, TrackID.net, set79, Djooni), a SoundCloud DJ set, an audio recording, or a TXT / CSV file. CatchIt! creates a tracklist that lives in the Inbox sidebar; you research and classify its rows the same way you do single songs.

A chart is the living cousin of a tracklist: a Beatport chart you follow and refresh whenever you want to see what's new. Charts get their own section in the Inbox sidebar — see Charts below.

Adding a tracklist

In the Inbox sidebar, click the + button on the TRACKLISTS header. The Add Tracklist sheet opens on "What are you adding?" with six choices, each with a one-line description:

Pick whichever matches what you have. Once a run starts, the sheet collapses the choice to a single row so the progress card has room, and it shows a summary when the run ends. The new tracklist appears in the sidebar and is selected automatically when the import finishes.

Apple Music Playlist — import from Apple Music or Spotify

Paste any Spotify or Apple Music playlist link — CatchIt! auto-detects the platform and validates the URL live. Supported forms:

• Spotify: https://open.spotify.com/playlist/... links (tracking parameters and locale segments are fine) and spotify:playlist:... URIs
• Apple Music: https://music.apple.com/.../playlist/... links — both public catalog playlists and playlists from your own library

Click Import Playlist and CatchIt! pulls in the playlist's tracks as a new tracklist. A few things to know:

• You need the service connected. Importing from Spotify requires your Spotify connection; Apple Music likewise. The sheet tells you if the selected service isn't connected yet — see Playback & streaming services.
• 500-track limit. Playlists larger than 500 tracks import the first 500 and tell you how many were skipped.
• Re-import guard. If you've already imported the same playlist link, CatchIt! asks before importing it again as a new tracklist.

Tracks arrive already matched on the playlist's service — no Research needed. Tracks that aren't available there are skipped, and the summary tells you how many. Close the summary and the tracklist opens in your Inbox, ready to classify.

Tracklist URL — 1001tracklists, TrackID.net, set79, Djooni

Paste a tracklist page from one of four sites:

• 1001tracklists — any 1001tracklists.com page
• TrackID.net — any trackid.net page
• set79 — set79.com/tracklist/... pages
• Djooni — djooni.com/query/... pages

The sheet confirms a supported link ("Valid set79 URL", and so on) as you paste. CatchIt! reads the title + artist for each row and builds a tracklist; rows the site lists as unidentified are kept. When you're ready to listen, trigger Research on the tracklist and the search cascade runs each row against Apple Music and Spotify.

One caveat: it's read-as-is. If the source page has the wrong artist or a typo, CatchIt! searches for the wrong artist or the typo — see Troubleshooting.

Tracklist File — bring a list you already have

Choose a .csv or .txt file with title + artist rows. CatchIt! parses it with escalating smarts — standard format first, flexible detection next, and Apple Intelligence-assisted parsing for messy files — and reports how many tracks were imported and how many rows were skipped.

Typical use: a list you already keep in a spreadsheet or notes app. Apple's Shazam app has no export feature, so for pre-CatchIt! Shazam history, import your My Shazam Tracks playlist with Apple Music Playlist instead, or use the file from Apple's data request at shazam.com/privacy if it has title and artist columns (Apple doesn't document its contents) — see Cross-platform & sync.

SoundCloud — Shazam an online DJ set

Paste a SoundCloud set URL. CatchIt! fetches the audio and auto-Shazams the entire set, building a tracklist from the recognized tracks. A live progress card shows matches so far and current activity; you can stop a recognition run at any point and keep nothing.

Whole DJ sets from YouTube links are not supported. Single-track YouTube URLs work fine via paste / drag / share — see Capturing tracks.

Audio Recording — Shazam a recording

This is the one I use most. You're at a great venue, the music is excellent, you don't want to be on your phone. Open your phone's voice recorder — iOS Voice Memos works, any third-party recorder works — keep your phone in your pocket, and let it record the room.

When you get home, transfer the audio file to your Mac and drop it into the Audio Recording type. CatchIt! runs Shazam across the recording:

1. It segments the file into ~12-second windows along a base 10-second stride
2. Calls Shazam on each segment
3. Applies your filter thresholds (window size + min matches, below)
4. Adds successful matches to the tracklist

Recognition is adaptive — for stable, clearly-recognized tracks it skips ahead in bigger jumps to save time, so a two-hour set processes much faster than the worst case.

The pipeline is local — your audio file never leaves your Mac. Only the recognized track metadata syncs to the cloud.

Most matches will be real. Some will be false positives that turn out to be great tracks anyway — see Troubleshooting for why that's a feature.

Tuning recognition accuracy

When you process a long recording (a 2-hour DJ set, a club night), Shazam runs in segments. Two settings in Settings → Tracks Recognition (Shazam) let you trade precision for recall:

• Filter Window Size (default: 300 seconds, range 60–600) — how big the time-bucket is for grouping matches. Bigger buckets accept more variation; smaller buckets are stricter.
• Minimum Matches (default: 3, range 1–5) — a track needs at least this many Shazam hits inside one window to be considered real.

The defaults of 300 seconds + 3 matches encode my own working preferences exactly. Crank both up if you're tired of false positives. Crank both down if you're chasing every possible discovery.

Charts — follow a Beatport chart

A chart is a tracklist that keeps moving. Follow it once, then refresh it whenever you want to see what came in and what dropped out.

Which charts. Beatport only, and these pages:

• The Top 100 and the Hype 100 (beatport.com/top-100, beatport.com/hype-100)
• A genre's Top 100 or Hype 100 (beatport.com/genre/<genre>/<id>/top-100 or .../hype-100)
• A DJ's chart (beatport.com/chart/<name>/<id>)

Following one. Pick the Chart card in the Add Tracklist sheet — or click the + on the CHARTS header in the Inbox sidebar, which opens the sheet on the Chart card. Paste the chart link; the sheet names the chart for you ("Beatport Top 100 ✓"), so there's no title to type.

Under Match on, tick Spotify, Apple Music, or both. Connected services are ticked by default; a service you haven't connected can't be ticked yet. Every track is looked up by ISRC first, then by title — no Research click needed. If you tick nothing, the tracks are matched on the next refresh once a service is connected.

Click Follow Chart. The summary tells you how many tracks were followed, how many are playable on each service, and how many aren't — those keep their Beatport link. The chart now lives under CHARTS in your Inbox, and its tracks are ready to classify like any other: Enter keeps, Space rejects.

A few things to know:

• Refresh is manual. Nothing runs on a schedule. Hit ↻ Refresh in the chart's header, or right-click the chart in the sidebar → Refresh. CatchIt! reads the chart again, updates positions, adds new entries, matches anything still unmatched, and tells you what changed — e.g. "12 new · 68 still charting · 20 left the chart".
• Tracks that drop off stay. They show left in the position column and sort to the bottom. Your decisions on them are kept.
• Already following it? Pasting a chart you already follow offers to refresh it instead.
• Pasted a chart into Tracklist URL? The sheet points you to the Chart card with a one-click "Follow it as a chart instead".
• Unfollow from the chart's right-click menu. Its tracks, your decisions and their matches are preserved.

How charts look in the Inbox — the sidebar row, the header, the Charting / Left filter — is covered in The Inbox.

After the import

Every tracklist ends up in the same loop: open it in the Inbox sidebar, hit Research, then classify with Enter / Space. The whole review workflow — presets, filters, shortcuts, auto-advance — is next: The Inbox.