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.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.
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.Matching sets how wide the 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.
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). 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. 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.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.
Alpha
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.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dub","description":"Timecode vinyl for scratch DJs and sound systems. The manual for Dub, the open-source DVS for macOS.","colors":{"primary":"#A8752F","light":"#D9A33A","dark":"#C49157"},"logo":{"light":"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/logo/light.svg?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=c66e63054545147233df8bceb8bf885d","dark":"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/logo/dark.svg?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=9de389f24e6e3bee1432836b0a806ae1"},"favicon":"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/favicon.png?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=822c249106c922f25eace67503dac857","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://github.com/kLOsk/dub/issues","label":"Report a bug"}],"primary":{"type":"github","href":"https://github.com/kLOsk/dub"}},"footer":{"socials":{"github":"https://github.com/kLOsk/dub"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Download","icon":"download","href":"https://github.com/kLOsk/dub/releases/latest"},{"anchor":"Source on GitHub","icon":"github","href":"https://github.com/kLOsk/dub"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dub-3ccc829c","hasAudioNarration":false,"actualSubdomain":"dub-3ccc829c","customDomains":[],"gitSource":{"type":"github","owner":"klosk","repo":"dub","deployBranch":"main","contentDirectory":"site","isPrivate":false,"mountPath":"","label":"","_id":"6afaf4dbdd50ae575c5bef20"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afd6d63801696bcb625221d","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Manual","count":16},{"language":"default","tag":"Developers","count":6},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Library","count":4},{"language":"default","tag":"Playing","count":3},{"language":"default","tag":"Settings","count":2},{"language":"default","tag":"Prep and records","count":2},{"language":"default","tag":"Help","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"preferences","slug":"/preferences","pageMetadata":{"title":"Preferences","description":"Every setting in Dub's Preferences, tab by tab, and what each one does.","icon":"gear","href":"/preferences"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Every setting in Dub’s Preferences, tab by tab, and what each one does.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Open Preferences with `,_jsx(_components.strong,{children:`⌘,`}),` or the gear at the right end of the top bar.\nEvery setting applies the moment you change it; there’s nothing to save.\n`,_jsx(_components.strong,{children:`Close`}),` or `,_jsx(_components.strong,{children:`Escape`}),` shuts the sheet. `,_jsx(_components.strong,{children:`Show Welcome Guide`}),` at the bottom\nopens the first-run guide again.`]}),`\n`,_jsx(_components.p,{children:`The tabs run down the left, in this order.`}),`\n`,_jsx(Heading,{level:`2`,id:`audio`,children:`Audio`}),`\n`,_jsxs(_components.p,{children:[`Where each deck comes in and goes out. With a DJ interface plugged in, this\ntab shows the interface and each deck’s input and output pair: read-only for\nan interface Dub knows, set by you for one it doesn’t. See\n`,_jsx(_components.a,{href:`/hardware#setting-up-your-interface`,children:`Setting up your interface`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`With no interface connected, it shows the `,_jsx(_components.strong,{children:`Mode`}),` and `,_jsx(_components.strong,{children:`Device`}),` Dub is\nrunning on: Track Preparation through the built-in output.`]}),`\n`,_jsx(Heading,{level:`2`,id:`decks`,children:`Decks`}),`\n`,_jsx(_components.p,{children:`How a deck behaves when a track lands on it.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Browse mode`})}),_jsx(_components.td,{children:`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.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Keep the menu bar away in full screen`})}),_jsxs(_components.td,{children:[`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: `,_jsx(_components.strong,{children:`⌘,`}),` for Preferences, `,_jsx(_components.strong,{children:`⌃⌘F`}),` to leave full screen, `,_jsx(_components.strong,{children:`⌘Q`}),` to quit (Dub asks first: click `,_jsx(_components.strong,{children:`Quit`}),` to quit, `,_jsx(_components.strong,{children:`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.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Allow loading onto a playing deck`})}),_jsxs(_components.td,{children:[`In Performance. Off, a drop or `,_jsx(_components.strong,{children:`Space`}),` load onto a running deck is refused and the deck flashes red; lift the needle or pause first. Prep always allows the load.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Auto-match loudness on load`})}),_jsx(_components.td,{children:`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.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Snap cue points to the beat grid`})}),_jsx(_components.td,{children:`A hot cue you set lands on the nearest beat line. Off, it lands exactly at the playhead.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Show what you usually play next`})}),_jsxs(_components.td,{children:[`In Performance, the deck shows `,_jsx(_components.strong,{children:`↝ 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.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`fx`,children:`FX`}),`\n`,_jsx(_components.p,{children:`The dub instruments on the surface.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Echo out`})}),_jsxs(_components.td,{children:[`One `,_jsx(_components.strong,{children:`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.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Dub siren`})}),_jsxs(_components.td,{children:[`The siren box on the rack bar: five shots (Rifle Gun, Alarm, Sine, Laser, Siren) and a `,_jsx(_components.strong,{children:`DUB`}),` knob for the box’s own echo. Keys come from `,_jsx(_components.a,{href:`/map-mode`,children:`map mode`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Beat-match the siren’s echo`})}),_jsxs(_components.td,{children:[`Locks the siren’s echo to the deck’s tempo, so the repeats fall in time with the tune, instead of following the `,_jsx(_components.strong,{children:`DUB`}),` knob. Needs `,_jsx(_components.strong,{children:`Dub siren`}),` on.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`library`,children:`Library`}),`\n`,_jsxs(_components.p,{children:[`The DJ apps whose libraries Dub reads into your one collection: `,_jsx(_components.strong,{children:`Serato`}),`,\n`,_jsx(_components.strong,{children:`Traktor`}),`, `,_jsx(_components.strong,{children:`rekordbox`}),` and `,_jsx(_components.strong,{children:`Apple Music`}),`. Turn one on and Dub scans its\ndefault folder now and on every launch, read-only, and shows that app’s crates\nand playlists in the sidebar. Each row says whether the library was found and\nwhere. `,_jsx(_components.strong,{children:`Rescan`}),` reads it again. On the Apple Music row, `,_jsx(_components.strong,{children:`Choose…`}),` picks\nwhich of Music’s libraries Dub reads, and `,_jsx(_components.strong,{children:`Default`}),` goes back to Music’s\nusual one. See\n`,_jsx(_components.a,{href:`/library/import#apple-music`,children:`Bring your library`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Matching`}),` sets how wide the `,_jsx(_components.a,{href:`/library/organize#matching`,children:`Matching`}),` smart\ncrate looks: `,_jsx(_components.strong,{children:`Tempo`}),`, how many BPM either side of the playing track (3 to\nstart), and `,_jsx(_components.strong,{children:`Key`}),`, how many steps round the Camelot wheel (1 to start: a\nstep either way and the relative major or minor; 0 is the same key only).\n`,_jsx(_components.strong,{children:`Half and double time`}),` also matches a track at half or double the tempo,\nan 87 BPM track beside a 174 one. `,_jsx(_components.strong,{children:`Match the pitched tempo`}),` matches the\ntempo the deck plays at now, with your platter’s pitch on it, instead of the\ntrack’s own BPM. Both start off.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`When a track is in more than one app`}),` explains whose beat grid and whose\nhot cues a track gets: your own fixes in Dub first, then Serato, rekordbox\nand Traktor in that order. See\n`,_jsx(_components.a,{href:`/library/import#a-track-in-more-than-one-app`,children:`A track in more than one app`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`vinyl`,children:`Vinyl`}),`\n`,_jsx(_components.p,{children:`Recording records into the library, and naming what you ripped.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Vinyl recording`})}),_jsxs(_components.td,{children:[`Record a side through your DJ interface in Prep. A `,_jsx(_components.strong,{children:`PREP · REC · PERF`}),` switch appears in the top bar; `,_jsx(_components.strong,{children:`REC`}),` starts a rip (`,_jsx(_components.a,{href:`/rip`,children:`how`}),`). `,_jsx(_components.strong,{children:`PERF`}),` shows only while an interface is connected.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`AcoustID key`})}),_jsxs(_components.td,{children:[`Your free key from acoustid.org. Without it, `,_jsx(_components.strong,{children:`Identify`}),` in the rip review panel does nothing.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Also identify the pressing`})}),_jsx(_components.td,{children:`Adds album, label and catalogue number by asking MusicBrainz. Slower, and it often can’t settle on one release for a compilation.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Discogs token`})}),_jsxs(_components.td,{children:[`Optional, shown once `,_jsx(_components.strong,{children:`Also identify the pressing`}),` is on. Adds Discogs’ style tags and pressing detail. It’s kept in your login Keychain.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`keys`,children:`Keys`}),`\n`,_jsxs(_components.p,{children:[`What the keyboard fires. Controls on the surface are mapped there; see\n`,_jsx(_components.a,{href:`/map-mode`,children:`Map mode`}),`. This tab maps the actions that have no button to\nclick: loading into a deck, instant doubles, loop off, and the library\nkeys. See `,_jsx(_components.a,{href:`/map-mode#actions-with-no-button`,children:`Actions with no button`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`It also explains the modifiers, lists every control bound on the surface\nwith its key, and has `,_jsx(_components.strong,{children:`Reset all bindings…`}),`, which puts back\n`,_jsx(_components.a,{href:`/map-mode#dubs-own-keys`,children:`Dub’s own keys`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`alpha`,children:`Alpha`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Alpha features work but aren’t finished. They will change. They’re off by\ndefault; leave them off at a gig.`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Alpha features`})}),_jsx(_components.td,{children:`The master switch. Off, every feature below is gone from the surface, whatever its own switch says.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Dub FX channel`})}),_jsxs(_components.td,{children:[`Adds a `,_jsx(_components.strong,{children:`DUB FX`}),` position to each deck’s source switch, and `,_jsx(_components.strong,{children:`HOLD`}),` to each deck’s echo. See `,_jsx(_components.a,{href:`/dub-fx`,children:`DUB FX`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Following beat grid`})}),_jsxs(_components.td,{children:[`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 `,_jsx(_components.a,{href:`/dub-fx#following-beat-grid`,children:`DUB FX`}),`.`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Preferences","description":"Every setting in Dub's Preferences, tab by tab, and what each one does.","icon":"gear","href":"/preferences"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Audio","slug":"audio","depth":2,"children":[]},{"title":"Decks","slug":"decks","depth":2,"children":[]},{"title":"FX","slug":"fx","depth":2,"children":[]},{"title":"Library","slug":"library","depth":2,"children":[]},{"title":"Vinyl","slug":"vinyl","depth":2,"children":[]},{"title":"Keys","slug":"keys","depth":2,"children":[]},{"title":"Alpha","slug":"alpha","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"dub-3ccc829c","siteName":"Dub","title":"Preferences - Dub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T09:18:30.675Z","originalFileLocation":"preferences.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Every setting in Dub\u0026#x27;s Preferences, tab by tab, and what each one does.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Preferences - Dub\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every setting in Dub\u0026#x27;s Preferences, tab by tab, and what each one does.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dub-3ccc829c.mintlify.app/preferences\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dub-3ccc829c.mintlify.site/_mintlify/api/og/v2?division=Settings\u0026amp;title=Preferences\u0026amp;description=Every+setting+in+Dub%27s+Preferences%2C+tab+by+tab%2C+and+what+each+one+does.\u0026amp;theme=958ea07cad40b39620a45bca\u0026amp;signature=467604d9e170429997c5398a41f84336ea8d4e55c330bfbb6518f7cb98bbacdc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Preferences - Dub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every setting in Dub\u0026#x27;s Preferences, tab by tab, and what each one does.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dub-3ccc829c.mintlify.site/_mintlify/api/og/v2?division=Settings\u0026amp;title=Preferences\u0026amp;description=Every+setting+in+Dub%27s+Preferences%2C+tab+by+tab%2C+and+what+each+one+does.\u0026amp;theme=958ea07cad40b39620a45bca\u0026amp;signature=467604d9e170429997c5398a41f84336ea8d4e55c330bfbb6518f7cb98bbacdc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A8752F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dub-3ccc829c.mintlify.app/preferences\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/preferences.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dub-3ccc829c.mintlify.app/#organization\",\"name\":\"Dub\",\"url\":\"https://dub-3ccc829c.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/logo/light.svg?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=c66e63054545147233df8bceb8bf885d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://dub-3ccc829c.mintlify.app#website\",\"name\":\"Dub\",\"url\":\"https://dub-3ccc829c.mintlify.app\",\"publisher\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dub-3ccc829c.mintlify.app/preferences#webpage\",\"url\":\"https://dub-3ccc829c.mintlify.app/preferences\",\"name\":\"Preferences\",\"description\":\"Every setting in Dub's Preferences, tab by tab, and what each one does.\",\"dateModified\":\"2026-11-18T09:18:30.675Z\",\"isPartOf\":{\"@id\":\"https://dub-3ccc829c.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/preferences#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dub-3ccc829c.mintlify.app/preferences#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dub\",\"item\":\"https://dub-3ccc829c.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Preferences\",\"item\":\"https://dub-3ccc829c.mintlify.app/preferences\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://dub-3ccc829c.mintlify.app/preferences#article\",\"headline\":\"Preferences\",\"name\":\"Preferences\",\"description\":\"Every setting in Dub's Preferences, tab by tab, and what each one does.\",\"url\":\"https://dub-3ccc829c.mintlify.app/preferences\",\"mainEntityOfPage\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/preferences#webpage\"},\"dateModified\":\"2026-11-18T09:18:30.675Z\",\"publisher\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://dub-3ccc829c.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dub\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dub\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/preferences.md","siteName":"Dub","nav":{"global":{"anchors":[{"anchor":"Download","icon":"download","href":"https://github.com/kLOsk/dub/releases/latest"},{"anchor":"Source on GitHub","icon":"github","href":"https://github.com/kLOsk/dub"}]},"tabs":[{"tab":"Manual","groups":[{"group":"Get started","pages":[{"title":"Dub","sidebarTitle":"Introduction","icon":"record-vinyl","href":""},{"title":"Install Dub","icon":"download","href":"/install"},{"title":"Hardware","icon":"sliders","href":"/hardware"},{"title":"Your first set","icon":"record-vinyl","href":"/first-set"}]},{"group":"Playing","pages":[{"title":"The deck","icon":"compact-disc","href":"/performance/decks"},{"title":"Samples and the siren","icon":"bullhorn","href":"/performance/samples-and-siren"},{"title":"Map mode","icon":"keyboard","href":"/map-mode"}]},{"group":"Prep and records","pages":[{"title":"Prep","icon":"headphones","href":"/prep"},{"title":"Rip your vinyl","icon":"compact-disc","href":"/rip"}]},{"group":"Library","pages":[{"title":"Bring your library","icon":"folder-open","href":"/library/import"},{"title":"Your library","icon":"table-list","href":"/library/organize"},{"title":"Export","icon":"file-export","href":"/library/export"},{"title":"Lexicon","description":"Get a library managed in Lexicon into Dub, and what survives the trip.","icon":"arrows-rotate","href":"/library/lexicon"}]},{"group":"Settings","pages":[{"title":"Preferences","icon":"gear","href":"/preferences"},{"title":"DUB FX (alpha)","description":"Turn a deck into an outboard effects rack on your mixer's send, hold an echo through a record swap, and let the beat grid follow a band.","icon":"flask","href":"/dub-fx"}]},{"group":"Help","pages":[{"title":"Troubleshooting","icon":"life-ring","href":"/troubleshooting"}]}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/developers/build"}]}]},"basePath":"","title":"Preferences - Dub","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}