> ## 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.

# Map mode

> Put the controls you play on the keys you want: turn MAP on, click a control, press a key.

## Dub's own keys

Dub starts with a full map. The left hand plays deck **A** and the right hand
plays deck **B**:

| Key | What it does |
| - | - |
| **1 2 3 4 5** · **6 7 8 9 0** | Hot cues 1–5 on deck A · on deck B. Hold **⇧** (or **⌘⇧**, as in Serato) to clear one. |
| **Q** · **P** | Tap the BPM, deck A · deck B: 1–2 taps set the 1, 3 or more the tempo. Hold **⇧** to halve a track's tempo, **⌥** to double it. |
| **W** · **O** | Loop off, deck A · deck B |
| **T** · **Y** | Echo out, deck A · deck B |
| **A S D F** · **H J K L** | Quick Scratch pads, deck A · deck B |
| **Z X C V B N M ,** | Samples 1–8 |
| **Space** | Loads the library selection into the empty deck: A if both are, the other one if one is loaded. With both loaded, the deck that isn't the master. |
| **⇧←** · **⇧→** | Load the selection into deck A · deck B |
| **⌘⇧←** · **⌘⇧→** | Double onto deck A (from B) · onto deck B (from A) |
| **↑** · **↓** | Previous · next track in the library |
| **⌘F** | Jump to search |
| **⌘⇧↑** · **⌘⇧↓** | Previous · next playlist in the sidebar |
| **⌘←** · **⌘→** | Close · open the folder in the sidebar |
| **⌘,** | Opens Preferences |

**E R U I G** and the siren's shots start free. Every key
above moves like any other: map the control to another key, or give its key
to something else.

> [!NOTE]
>
> Coming from Serato? The cues, the loads, the doubles, the samples, the
> track and crate arrows and **⌘F** are Serato's keys on a Mac. The letter
> keys are Dub's own: Serato's are for pitch and play direction, which the
> turntable does in Dub. Plain **←** and **→** are left free for you.

## Map a control

**1. Turn MAP on**

Click **MAP** in the top bar. It lights while map mode is on. Every
control you can bind shows a dashed ring and its key cap, empty if
nothing is bound yet. The controls don't fire while MAP is on.

**2. Click a control**

The ring goes solid and the control says **PRESS A KEY**. Click it
again to let it go.

**3. Press the key**

The key is bound and its cap prints on the control. Map the next
control, or leave map mode.

**4. Click MAP to leave**

The controls play again, each with its key on it.

While a control waits for a key:

* **Escape** backs out without changing anything.
* **⌫** leaves the control with no key.
* A key with a modifier held is its own binding: **⇧←** and **←**, **⌘J**
  and **J** are different keys.
* A modifier on its own (⇧, ⌥, ⌃, ⌘) isn't a key; Dub waits for the real one.

**MAP** is on the **Performance** surface only. It isn't there in **Prep**,
or while you record a side.

## One key, one control

If you press a key that another control already has, the key moves: the new
control gets it and the old one is left with no key. That includes Dub's
own keys, **Space** among them.

**⌘,** can't be moved or taken. It's always the way back into Preferences.

## What you can map

| Where | Controls |
| - | - |
| Each deck | The hot cue pads, the Quick Scratch pads, every length on the loop row and its **÷2** / **×2**, **ECHO OUT**, key **LOCK**, and the **BPM**, to tap the 1 and the tempo |
| The rack bar | The siren's five shots, the sampler pads |
| The DUB FX channel ([alpha](https://dub-3ccc829c.mintlify.site/dub-fx.md)) | Each unit's **IN**/**OUT** toggle, the Space Echo's **HOLD** and **TAP**, the spring's **KICK**, and **HOLD** on each deck's echo |

## Actions with no button

Some actions have no control on the surface to click, so you map them in
**Preferences ▸ Keys ▸ Actions with no button**. Click the action's cap; it
says **PRESS A KEY**. Press the key. Escape, ⌫ and a key that's already
taken work as they do on the surface.

| Action | What it does |
| - | - |
| **Load into the left deck (A)**, **Load into the right deck (B)** | The library selection onto that deck. Refused while the deck plays, as for Space. |
| **Load into the empty deck** | What **Space** does. |
| **Double onto A (from B)**, **Double onto B (from A)** | The other deck's track, at its playhead. Dragging a deck's title still works too. |
| **Loop off A**, **B** | Ends that deck's loop, without finding the ✕ on the loop row. |
| **Jump to search** | Puts the cursor in the library's search field. |
| **Next track**, **Previous track** | Moves the library selection one row. With nothing selected, it starts at the top or the bottom. |
| **Next playlist**, **Previous playlist** | Moves through the sidebar, in the order you see it. A folder is a stop too. |
| **Open folder**, **Close folder** | Opens or folds the selected folder or app. Close on a playlist goes up to its folder. |

> [!TIP]
>
> Next track works from inside the search field too, as long as its key types
> nothing (like **↓**, the default, or an F-key): **⌘F**, type, **↓** lands on
> the first result, and Space loads it.

## Modifiers

A key with a modifier is a key of its own: **⇧←** loads deck A, while **←**
is free for something else.

When nothing is bound to the key with **⇧** or **⌥** held, they change what
the plain key does instead:

* **⇧** with a hot cue's key clears that cue.
* **⇧** with **Tap the BPM** halves a track's tempo; **⌥** doubles it.

## See and reset your map

**Preferences ▸ Keys** lists every bound control with its key, under
**BOUND NOW**. You map on the surface, not there.

**Reset all bindings…** at the bottom of that list puts Dub's own map back
and forgets what you mapped. It asks first.

If you mapped keys before Dub had its own map, yours stay: a key you bound
wins, and the default that wanted it goes without.

Dub saves your map on this Mac as you make it and keeps it across launches.

## MIDI

Map mode binds keys today. Binding MIDI controls the same way is planned.


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