Skip to main content
The library sits under the decks. The sidebar on the left picks what the list shows; the list on the right is your tracks.

The sidebar

Click a heading to fold its section away, and again to open it. The arrow beside each imported source folds its playlists, and a folder inside one, such as an Apple Music playlist folder, has an arrow of its own. Folders start folded; click the arrow, or an empty folder’s name, to open one. Dub remembers what you folded.

Matching

Matching lists what mixes with the track playing now: tracks whose key is next to it on the Camelot wheel and whose tempo is close, nearest first. It follows the music. When the next track takes over, the list changes with it. When nothing plays, it keeps the last track’s matches. A bar above the list names the track it matches and the window, for example 8A 7A 8B 9A · 121–127 BPM. Out of the box that’s a step either way round the wheel (and the relative major or minor) and 3 BPM either side; set both under Matching in Preferences ▸ Library, along with half and double time and matching the pitched tempo (both off to start). Tracks already on a deck don’t show, nor do tracks with no BPM or key yet. Keys match however your library spells them: Camelot (8A), musical (Am, F#) or Open Key (1m). Above the list is a strip of eight favourite slots. Drag a crate or a playlist from the sidebar onto a slot, then click the slot to open it. Right-click a slot and choose Clear Slot to empty it. Type in Search at the top of the sidebar. The list narrows as you type. The clear button at the end of the field empties it.

Filter

The FILTER bar above the list holds a box per field: Genre, BPM, Key and Rating to start with. Tick values in a box to show only those tracks. Each value shows how many tracks match.
  • BPM splits the list into tempo ranges, such as 124–128.
  • Rating shows tracks with at least the stars you click.
  • Tracks with an empty field collect under (none).
Add or remove boxes with the + at the right of the bar. Click the bar’s line to fold it away; folded, it still says what you’re filtering by. Click Clear to drop every filter.

Columns and sorting

Artist and Title are always there. Right-click a column header to show or hide the others:
  • Analysis: Length, BPM, Key
  • ID3 metadata: Album, Genre, Year, Comment, Composer, Track #
  • Library: Rating, Color, Version, Source
  • More columns: everything else, grouped. Each app you imported from gets its own group with its own BPM, key and tags, so you can put Serato BPM next to BPM (auto) and compare. There are also groups for the audio file (codec, rate, size, path) and for your Mix history (Plays, Last played).
Drag a header to move a column. Click a header to sort: once ascending, twice descending, a third time to turn the sort off. Empty cells always go to the bottom. The Key column is in Camelot, coloured around the wheel so compatible keys stand out down the list. Right-click a header and choose Toggle Key Notation (Musical) to read it as C major instead.

Crates

1

Make a crate

Click the + next to DUB CRATES and type a name.
2

Fill it

Drag tracks from the list onto the crate in the sidebar. A file dragged from the Finder joins only if it’s already in your library.
3

Put it in order

Open the crate. The # column is its running order; sort by it and drag rows to reorder. Or right-click a track: Move Up, Move Down, Move to Top, Move to Bottom.
Right-click a crate for Rename, Export As… and Delete. Deleting a crate removes only the list. The tracks stay in your library. Inside a crate, Remove from Crate takes the selected tracks out. Playlists under IMPORTED SOURCES are read-only. They show what the other app has; you can’t rename, reorder or drop into them.

Ratings and colours

Turn on the Rating and Color columns.
  • Rating: click a star to rate from one to five. Click the same star again to clear it.
  • Color: click the swatch and pick Red, Orange, Yellow, Green, Aqua, Blue, Purple or Pink, or None. The whole row takes a tint of the colour.

What you played

Dub records what each deck loads and plays. It never sees your mixer, so it works out a transition from the decks: when one deck stops while the other keeps playing a different track, and the outgoing track played for at least 30 seconds, that counts as a mix from one into the other.
  • Recently Played lists tracks you’ve loaded on a deck, newest first.
  • Session History is the set you’ve played since you opened Dub. A track you mixed into shows ← from and the track before it.
  • When you load a track you’ve mixed out of before, the deck in Performance shows ↝ usually: and the track you most often play next, between the elapsed and remaining time. Click it to find that track in the library, then press Space to load it. Turn it off with Show what you usually play next in Preferences ▸ Decks.

Analysis

Dub reads tempo, beat grid and key from the audio itself. It does this lazily: importing stays fast, and a track is analysed the first time you load it. The deck plays straight away and the BPM fills in a few seconds later. While it works, the bottom-right corner of the list shows Analyzing 1 track…. To analyse ahead of a gig, select tracks, right-click and choose Analyze (or Re-analyze for tracks done before). The menu counts what it will do: Re-analyze Selected (3 of 5) means two of the five have a locked grid and are skipped. Marks in the BPM column: A track shows one ⚠ however many of these apply, amber when the grids disagree. Hover it to see every problem it stands for. Key comes out as Camelot. A grid from another app stays in charge: Dub’s own reading sits beside it in BPM (auto) and Key (auto).

Duplicates

When you import, Dub fingerprints each file. A file that sounds the same as a track you already have, with the same length, joins that track as a second copy rather than a second row. Dub won’t merge versions. A title or filename marked (Clean), (Dirty), (Instrumental), (Acapella), (Radio Edit), (Extended Mix) or (12" Mix) stays its own track, and the Version column shows the tag. Versions of the same recording get a link icon in the row. Click it to jump to the other version.

Missing files

A track on a drive that’s unplugged shows a red triangle in its row. When files can’t be found, the bottom-right corner of the list counts them, for example 12 missing.
1

Open Relocate

Click the missing count. Relocate Missing Files opens.
2

Point Dub at the files

Click Match Folder… and choose the folder that now holds them. Dub matches files by fingerprint and length, so renamed files are found too.
3

Check the result

The sheet reports how many it relocated. Anything still missing can be tried against another folder.
Dub never deletes a track because its file went missing. Your grids, cues, ratings and history stay, and when the drive comes back the old path works again.