> ## Documentation Index
> Fetch the complete documentation index at: https://dub-3ccc829c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Preferences

> Every setting in Dub's Preferences, tab by tab, and what each one does.

Open Preferences with **⌘,** or the gear at the right end of the top bar.
Every setting applies the moment you change it; there's nothing to save.
**Close** or **Escape** shuts the sheet. **Show Welcome Guide** at the bottom
opens the first-run guide again.

The tabs run down the left, in this order.

## Audio

Where each deck comes in and goes out. With a DJ interface plugged in, this
tab shows the interface and each deck's input and output pair: read-only for
an interface Dub knows, set by you for one it doesn't. See
[Setting up your interface](https://dub-3ccc829c.mintlify.site/hardware.md#setting-up-your-interface).

With no interface connected, it shows the **Mode** and **Device** Dub is
running on: Track Preparation through the built-in output.

## Decks

How a deck behaves when a track lands on it.

| Setting | What it does |
| - | - |
| **Browse mode** | In Performance, clicking the library slides it up over the deck controls so you see more of the crate. Loading a track, or clicking outside the library, slides it back down. |
| **Keep the menu bar away in full screen** | On to start. The menu bar and Dock stay hidden even when the pointer reaches the edge of the screen, as in Serato. The keys still work: **⌘,** for Preferences, **⌃⌘F** to leave full screen, **⌘Q** to quit (Dub asks first: click **Quit** to quit, **esc** goes back to the decks). Off, macOS shows them at the edge. In full screen, three dots at the left of the top bar stand in for the window buttons: the left one quits (Dub asks first), the right one goes to window mode. |
| **Allow loading onto a playing deck** | In Performance. Off, a drop or **Space** load onto a running deck is refused and the deck flashes red; lift the needle or pause first. Prep always allows the load. |
| **Auto-match loudness on load** | A track with a measured loudness loads at a gain that matches the others, so you don't ride the trim. Off, tracks load untouched and you set level at the mixer. |
| **Snap cue points to the beat grid** | A hot cue you set lands on the nearest beat line. Off, it lands exactly at the playhead. |
| **Show what you usually play next** | In Performance, the deck shows **↝ usually:** and the track you've most often mixed into from the loaded one. Click it to find that track in the library. Learned from your own mixes; nothing leaves your Mac. |

## FX

The dub instruments on the surface.

| Setting | What it does |
| - | - |
| **Echo out** | One **ECHO OUT** button per deck. Tap it and the tune cuts to 100 % wet while the deck plays on underneath; tap again and it picks up where it has got to. |
| **Dub siren** | The siren box on the rack bar: five shots (Rifle Gun, Alarm, Sine, Laser, Siren) and a **DUB** knob for the box's own echo. Keys come from [map mode](https://dub-3ccc829c.mintlify.site/map-mode.md). |
| **Beat-match the siren's echo** | Locks the siren's echo to the deck's tempo, so the repeats fall in time with the tune, instead of following the **DUB** knob. Needs **Dub siren** on. |

## Library

The DJ apps whose libraries Dub reads into your one collection: **Serato**,
**Traktor**, **rekordbox** and **Apple Music**. Turn one on and Dub scans its
default folder now and on every launch, read-only, and shows that app's crates
and playlists in the sidebar. Each row says whether the library was found and
where. **Rescan** reads it again. On the Apple Music row, **Choose…** picks
which of Music's libraries Dub reads, and **Default** goes back to Music's
usual one. See
[Bring your library](https://dub-3ccc829c.mintlify.site/library/import.md#apple-music).

**Matching** sets how wide the [Matching](https://dub-3ccc829c.mintlify.site/library/organize.md#matching) smart
crate looks: **Tempo**, how many BPM either side of the playing track (3 to
start), and **Key**, how many steps round the Camelot wheel (1 to start: a
step either way and the relative major or minor; 0 is the same key only).
**Half and double time** also matches a track at half or double the tempo,
an 87 BPM track beside a 174 one. **Match the pitched tempo** matches the
tempo the deck plays at now, with your platter's pitch on it, instead of the
track's own BPM. Both start off.

**When a track is in more than one app** explains whose beat grid and whose
hot cues a track gets: your own fixes in Dub first, then Serato, rekordbox
and Traktor in that order. See
[A track in more than one app](https://dub-3ccc829c.mintlify.site/library/import.md#a-track-in-more-than-one-app).

## Vinyl

Recording records into the library, and naming what you ripped.

| Setting | What it does |
| - | - |
| **Vinyl recording** | Record a side through your DJ interface in Prep. A **PREP · REC · PERF** switch appears in the top bar; **REC** starts a rip ([how](https://dub-3ccc829c.mintlify.site/rip.md)). **PERF** shows only while an interface is connected. |
| **AcoustID key** | Your free key from acoustid.org. Without it, **Identify** in the rip review panel does nothing. |
| **Also identify the pressing** | Adds album, label and catalogue number by asking MusicBrainz. Slower, and it often can't settle on one release for a compilation. |
| **Discogs token** | Optional, shown once **Also identify the pressing** is on. Adds Discogs' style tags and pressing detail. It's kept in your login Keychain. |

## Keys

What the keyboard fires. Controls on the surface are mapped there; see
[Map mode](https://dub-3ccc829c.mintlify.site/map-mode.md). This tab maps the actions that have no button to
click: loading into a deck, instant doubles, loop off, and the library
keys. See [Actions with no button](https://dub-3ccc829c.mintlify.site/map-mode.md#actions-with-no-button).

It also explains the modifiers, lists every control bound on the surface
with its key, and has **Reset all bindings…**, which puts back
[Dub's own keys](https://dub-3ccc829c.mintlify.site/map-mode.md#dubs-own-keys).

## Alpha

> [!WARNING]
>
> Alpha features work but aren't finished. They will change. They're off by
> default; leave them off at a gig.

| Setting | What it does |
| - | - |
| **Alpha features** | The master switch. Off, every feature below is gone from the surface, whatever its own switch says. |
| **Dub FX channel** | Adds a **DUB FX** position to each deck's source switch, and **HOLD** to each deck's echo. See [DUB FX](https://dub-3ccc829c.mintlify.site/dub-fx.md). |
| **Following beat grid** | For records played by a band. A track whose beats wander off any even grid gets a line on each beat where the band played it, saved to the track and shown in cyan. Lock it to accept it. Off, every track plays its even grid again. See [DUB FX](https://dub-3ccc829c.mintlify.site/dub-fx.md#following-beat-grid). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.