CE HYBRID DJ
Play Traktor or CDJs into Ableton Live, one deck per track, with Live following the
key.
Getting started · 01
What CE HYBRID DJ does
Traktor or CDJs, played into Ableton Live as separate decks, with Live following the key.
CE HYBRID DJ connects a DJ setup to Ableton Live. Each deck arrives on its own Live track, so you can
process, record and mix it in Live, and Live's scale follows the key of the music you play.
| CE DJ SYNC | The main device. It reads Traktor or Pro DJ Link players, shows all four
decks, and deploys keys to Live's Global Scale and to your scale devices. Use one per Live Set. |
| CE DJ DECK | One per deck, on an audio track. It brings that deck's audio into the
track, shows the deck with its waveform, and can deploy the deck's key on its own. |
| CE HYBRID DJ Bridge | A virtual audio device for Traktor. Traktor plays each deck to
its own pair of channels, and CE DJ DECK reads them inside Live. |
| CE DJ DEPLOYER | Deploys the key to a scale
device placed after it. |
| CE SCALE MAPPER | Reads a scale device and drives a Pitch device, another scale
device, or a Macro. |
The preview at the top of this page runs the real CE DJ SYNC and CE DJ DECK faces, and their Settings
windows, with four demo decks. Click any control to read about it. It plays no audio.
Getting started · 02
What you need
Live 12.2 or later with Max 9, on macOS, and Traktor or Pro DJ Link players.
| Computer | A Mac. The Bridge and CE DJ DECK are macOS only for now. |
| Ableton Live | Live 12.2 or later with Max 9 (Live Suite, or Standard with Max for
Live). |
| Traktor | Traktor Pro, on the same Mac as Live, with the Traktor API installed. See
Install the Traktor API. |
| Or CDJs | Pro DJ Link players on the same network as the Mac. For their audio, a mixer
that sends each channel to the Mac over USB. |
You can use CE DJ SYNC on its own for key sync only. Add CE DJ DECK when you want the decks' audio in
Live.
Getting started · 03
Download and install
What is in the download, where to put it, and where to find it in Live.
The download unzips to one folder, CE HYBRID DJ:
M4L Devices/ | CE DJ SYNC, CE DJ DECK, CE DJ DEPLOYER and CE SCALE MAPPER. |
traktor-api-client-main/ | The Traktor API client and its licence. Its D2 folder goes
into Traktor: see Install the Traktor API. |
CE HYBRID DJ Bridge 0.1.0 beta.pkg | Installs CE HYBRID DJ Bridge, the audio device
Traktor plays to. |
Manual.html | This manual. Open it in any web browser. |
- Move the whole CE HYBRID DJ folder into your Live User Library. By default that is
Music/Ableton/User Library.
- In Live's browser, open Places → User Library → CE HYBRID DJ → M4L Devices. Drag the devices
from there onto your tracks.
- If you use Traktor, quit Traktor and Live, then double-click
CE HYBRID DJ Bridge 0.1.0
beta.pkg. It restarts the Mac's audio system at the end, so audio stops for a moment.
The beta installer isn't signed by Apple yet, so the first time you open it macOS
says it can't verify it and won't open it. Click
Done, then:
- Open System Settings → Privacy & Security.
- Scroll down to Security. Next to the message that the installer was blocked, click
Open Anyway.
- Confirm with Open Anyway and your password. The installer opens. Do this soon after the first
try: the button only shows for about an hour.
Not sure where your User Library is? Live shows its location under
Settings → Library.
Getting started · 04
Install the Traktor API
Traktor only. Replace the D2 folder so CE DJ SYNC can read Traktor.
Overwrite the D2 folder to allow access to the Traktor API. Skip this section if you use CDJs.
- Navigate to
/Applications/Native Instruments/Traktor Pro
- Right click
Traktor.app, then click Show Package Contents
- Navigate to
Contents/Resources/qml/CSI
- Make a backup of the D2 folder
- Replace the D2 folder with the D2 folder in
traktor-api-client-main
- Restart Traktor
If you don't own a Traktor Kontrol D2:
- Go to Preferences > Controller Manager
- Below the Device dropdown, click Add… > Traktor > Kontrol D2
CE DJ SYNC listens on port 64100, the number set in
ApiClient.js. See CE DJ SYNC
Settings if you need to change it.
Getting started · 05
Quick start
From an empty Set to four decks in Live, following the key.
- Set up your decks: Traktor or
CDJs.
- Drop CE DJ SYNC on any MIDI track. Choose Traktor or Pro DJ Link at its top left. When it shows
Connected, load and play a track. Its title, key and artwork appear.
- Add four audio tracks and drop CE DJ DECK on each. Choose Deck A to D at the top left of each one.
Each track now plays its deck.
- Turn on Global Scale in CE DJ SYNC, and enable Global Scale Awareness in Live so your devices follow
it.
- Click a deck letter in CE DJ SYNC to deploy its key now, or choose Auto to deploy on your
KEY cue or after a Count In.
Only one CE DJ SYNC per Set. CE DJ DECK finds it by itself.
Connect your decks · 06
Traktor
Route each deck to its own channels of CE HYBRID DJ Bridge.
Traktor plays to CE HYBRID DJ Bridge. Each deck goes to its own pair of channels, and CE DJ DECK reads
that pair inside Live. Live keeps your audio interface for its input and output.
- In Traktor, open Preferences → Audio Setup and choose CE HYBRID DJ Bridge as the Audio
Device.
- Open Output Routing. Set Mixing Mode to External, then route the decks as below.
- Set Traktor's sample rate to the one Live uses (Live → Settings → Audio).
| Traktor output | Bridge channels |
| Output Deck A | 1 and 2 (Deck A L, Deck A R) |
| Output Deck B | 3 and 4 |
| Output Deck C | 5 and 6 |
| Output Deck D | 7 and 8 |
With Mixing Mode set to External, Traktor's own mixer, EQs and headphone cue are out of the path. Live is
the mixer.
Microphone access. Reading any audio input on a Mac, the Bridge included, needs
microphone permission. The first time CE DJ DECK reads the Bridge, Live asks for it. If you said no, turn
Ableton Live on in System Settings → Privacy & Security → Microphone, then restart Live.
Connect your decks · 07
CDJs and a DJM
Pro DJ Link for the decks, the mixer's USB audio for the sound.
- Connect the Mac to the same network as the players, through the same switch or router.
- In CE DJ SYNC, choose Pro DJ Link at the top left. Players 1 to 4 appear as decks A to D.
- For audio, connect the mixer to the Mac over USB and set it to send each channel to the computer.
Your mixer's manual describes its USB audio settings.
- In each CE DJ DECK, open the gear and choose the mixer's channel pair in the Input menu. See
CE DJ DECK Settings.
Live's own audio device stays your choice. CE DJ DECK reads the mixer's USB channels directly.
For Key Cue with CDJs, choose in CE DJ SYNC's Settings whether the cue is the one commented KEY or a hot
cue number. See Key Cue.
CE DJ SYNC · 08
The CE DJ SYNC display
Now playing on the left, the four decks on the right, and the key that went out.
| Source | Traktor or Pro DJ Link. The green dot and Connected beside it show
that data is arriving. |
| Now playing | The deck CE DJ SYNC treats as playing, with its artwork, title, artist
and key. That is the playing master deck, or else the deck that started playing most recently, or else
the track loaded most recently. |
| Decks | Decks A to D with artwork, key and title. A green dot means playing and red
means on air. A purple DECK chip means a CE DJ DECK deploys that deck itself (see
Deploying from CE DJ DECK). |
| Deployed | The key Live has now. Every deck letter in that key lights orange, so two
decks in the same key both light. |
Keys show in the notation Traktor or the players send: Am,
Camelot 8A or
Open Key 1m.
CE DJ SYNC · 09
Deploying a key
A deck letter deploys that deck. Deploy deploys the track that is now playing.
| Deck letters | Click A, B, C or D to deploy that deck's key, whatever the mode. You can
click a deck whose key is already deployed. Nothing changes, and the letter flashes to show the
click. |
| Deploy | Deploys the key of the now playing track. It always works, in Manual and in
Auto, and you can map it to a MIDI controller. |
A deploy goes to Live's Global Scale (if Global Scale is on)
and to every CE DJ DEPLOYER in the Set.
CE DJ SYNC · 10
Manual and Auto
Hold the key until you deploy, or deploy via Key Cue or Count In.
Manual: nothing deploys until you click Deploy or a deck letter. The hint under the controls says
so.
Auto: keys deploy by themselves, via Key Cue or Count In.
| Key Cue | The key deploys when the playing track reaches its KEY cue. See
Key Cue. |
| Count In | Once a track starts playing, its key deploys after the number of bars in
the menu next to it. At None, the key deploys as soon as a new track plays. |
Count In follows Live's transport. Bars are counted from Live's playing clock in
4/4, so anything longer than None needs Live's transport running. If Live is stopped, use None or Key
Cue.
CE DJ SYNC · 11
Key Cue
Mark the point in each track where Live should take its key.
Mark, once, the point in each track where Live should take the new key. From then on the track deploys
itself while you mix, and you can bring it in early and blend as long as you like.
Traktor
- Load the track and store a cue point where Live should change key, usually the start of the first
melodic section.
- Rename that cue to
KEY, in capitals, and save the track.
CDJs
In CE DJ SYNC's Settings, choose Cue commented KEY to use a memory or hot cue whose comment is
KEY (set it in rekordbox), or Hot cue number to use the same hot cue in every
track.
What happens
- It fires on the crossing, once per pass. Playing on past the cue does not keep redeploying.
Loading a new track arms the deck again, and so does looping back across the cue.
- It is per deck. Whichever deck passes its own KEY cue deploys that deck's key.
The name has to be exactly KEY. Key, KEY1 and
KEY IN do not match. Key Cue only runs in Auto with Key Cue selected.
CE DJ SYNC · 12
Global Scale
Whether a deploy changes Live's own Root and Scale.
Global Scale: this toggle controls whether CE DJ SYNC updates Live's Root and Scale. Global Scale
Awareness needs to be enabled in Live for it to work. It is the easiest way to control every scale aware device at once:
Arpeggiators, Auto Shifter, Drift, Meld and anything else set to follow the Global Scale.
Turn it off when you only want certain instruments keyed. CE DJ DEPLOYER still receives every
deploy.
Undo. Writing Live's Root and Scale is a change to your Set, so Live records an undo
step. CE DJ SYNC only writes when the key actually differs.
CE DJ SYNC · 13
CE DJ SYNC Settings
The Traktor port, Reconnect, and which cue counts as KEY on CDJs.
Click the gear at the top right to open the Settings window.
| API Port | The port CE DJ SYNC listens on for Traktor. It must match the port in
Traktor's ApiClient.js: 64100 unless you changed it. |
| Reconnect | Restarts the connection. The dot beside it turns green when data arrives. |
| Key Cue | Pro DJ Link only: Cue commented KEY or Hot cue number. |
| Hot Cue | The hot cue that deploys, when Key Cue is set to Hot cue number. |
| Follow CDJs | Pro DJ Link only: Live's tempo follows the CDJs. See
Live follows the CDJs. |
| Line up | Whether Live lines up its bars with the master player's, or only its beats. |
| Latency | Moves Live earlier or later against the CDJs, in milliseconds. |
| Help | Opens this manual. |
CE DJ SYNC · 14
Live follows the CDJs
Live's tempo and bars follow the tempo master player, through Ableton Link.
With CDJs on Pro DJ Link, CE DJ SYNC can keep Live in time with them. Whichever player is tempo master
sets Live's tempo, and Live's beats and bars line up with that player's. When the DJ makes another player
master, Live follows that one. Clips, loops and warped tracks in Live then play in time with the decks.
CE DJ SYNC joins Live's Ableton Link session. The CDJs are not on Link: CE DJ SYNC listens to the master
player and moves the Link session to match. Live only follows. Changing Live's tempo while this is on lasts
until the next beat from the player.
- Set the Source to Pro DJ Link.
- In Live's Settings → Link, Tempo & MIDI, turn on Show Link Toggle, then click the
Link button in Live's control bar.
- In CE DJ SYNC's Settings, set Follow CDJs to On. A LINK chip appears on CE DJ SYNC.
It turns green once Live follows a player.
- If Live sounds late against the CDJs, raise Latency a few milliseconds at a time. If it sounds
early, lower it.
The status line under the settings says what is missing when the chip is orange: Link in Live, a tempo
master, or a master that is playing. While the master is paused, Live keeps its last tempo.
Other Link apps. Anything else in the Link session follows too, such as Traktor with
its Link sync on, or a drum machine app. Rekordbox and Beat Link Trigger can't run on the same Mac, because
they hold the Pro DJ Link ports.
CE DJ SYNC · 15
Deck View
Every deck in a window that stays on top, in four layouts.
Click the waveform icon at the top right of CE DJ SYNC to open Deck View. It floats above Live, so you can
keep it in view while you work.
Each deck shows its player number, artwork, title, artist, status (ON AIR, MASTER, SYNC, PLAY), tempo,
time, a beat counter and its key. The key box glows when that deck's key is the one Live has now, and its
DEPLOY button works like the deck letters. Waveforms show the whole track and a scrolling close-up
with the beat grid and your KEY cue.
| View | Use it for |
| Vertical | Decks stacked, with the widest waveforms. |
| Horizontal | Decks side by side in a short, wide window. Up to four decks. |
| Grid | Two by two. |
| Compact | One slim row per deck, no waveforms: number, artwork, title, status, tempo,
time left, key and Deploy. |
The Compact view, in Camelot. Decks 1 and 3 are in 8A (A minor), Live's current key, so both
glow.
Switching view resizes the window to fit it. You can still drag the window to any size, and the view and
size are saved with your Set.
| Key | The notation for keys in Deck View: Musical, Camelot or Open Key. |
| Waveform | With CDJs, 3-Band or RGB. It applies to loaded tracks straight away, CE DJ DECK included, and is saved with your
Set. A track without that style shows the other. |
| Frame rate and Detail | Lower the frame rate, or turn the close-up waveform off,
to save CPU. Compact has neither, as it draws no waveforms. |
CE DJ DECK · 16
Adding CE DJ DECK
One audio track per deck. The device brings the deck in itself.
- Add an audio track for each deck and drop CE DJ DECK on it.
- Click the deck menu at the top left and choose Deck A, B, C or D.
- Play the deck. Its audio comes out of the track, and the meters on the right move.
The device replaces the track's input with the deck. You don't need to set the track's input or arm
it. Put effects after CE DJ DECK, mix with the track's fader, and record the track like any other.
Connected at the top means CE DJ DECK has found CE DJ SYNC. The deck's title, artwork, waveform
and key come from there, so add CE DJ SYNC to the Set too. The audio works without it.
CE DJ DECK · 17
The CE DJ DECK display
The deck, its waveform, and how its audio is arriving.
| Track | Artwork, title, artist, key and tempo. Below them, PLAY, MASTER and SYNC
light as on the deck. With CDJs, ON AIR shows the mixer channel's state. |
| Waveform | The whole track, with the play position. Your
KEY cue is the orange marker. Other cues are grey ticks. |
| Elapsed and remaining | Time played and time left. |
| Audio | A green dot with the added delay and the
clock drift when audio is arriving. Otherwise it says what is
wrong: see Troubleshooting. |
| Deployed | The last key this device deployed, or via CE DJ SYNC in Sync.
During a Count In it shows how long is left. |
CE DJ DECK · 18
Deploying from CE DJ DECK
Sync leaves it to CE DJ SYNC. Manual and Auto make this deck deploy itself.
| Sync | CE DJ SYNC deploys this deck, with its own settings. CE DJ DECK only shows it.
New devices start here, so adding a CE DJ DECK changes nothing until you choose. |
| Manual | A new key on this deck waits for this device's Deploy. NEW KEY shows
while one is waiting. |
| Auto | This deck deploys itself, via Key Cue or Count In, as described in
Manual and Auto. |
In Manual or Auto, CE DJ DECK takes charge of its deck. CE DJ SYNC's own Auto skips that deck and shows
the purple DECK chip next to it. Choose Sync again, or delete the CE DJ DECK, to hand the deck
back.
Global Scale and Count In work as they do on CE DJ SYNC, for this deck only. A deploy from
here reaches Live's Global Scale and every CE DJ DEPLOYER, the same as one from CE DJ SYNC.
Deck letters still work. Clicking a deck letter in CE DJ SYNC deploys that deck in
any mode.
CE DJ DECK · 19
CE DJ DECK Settings
Where the audio comes from, and how it is arriving.
Click the gear at the top right to open the Settings window.
Input chooses where the audio comes from:
| Traktor bridge (follows deck) | The deck's channels on CE HYBRID DJ Bridge. Change the
deck menu and the input follows. |
| A device and a pair | Any other audio input, such as a DJM's USB channels. If that
device is unplugged, the choice stays saved and picks up again when it comes back. |
Audio shows what CE DJ DECK is receiving:
| State | Receiving audio, Waiting for audio, or the problem (see
Troubleshooting). |
| Sample rate | The input's rate and Live's. They must match. |
| Added latency | How far behind the source the track plays, in milliseconds. It is
set when audio starts, and only grows if the input keeps arriving late. |
| Clock drift | How far the input's clock and Live's differ. CE DJ DECK corrects for it,
so a few ppm is normal. |
| Dropouts | Gaps in the audio since the device started. It should stay at None. |
Deployer and Scale Mapper · 20
CE DJ DEPLOYER
Deploys every key to a scale device.
This MIDI device receives every key deployed by CE DJ SYNC or CE DJ DECK and deploys it to a scale
device.
Auto Mode: the Deployer controls a scale device placed directly after (to the right of) it.
Manual Mode: click Map, then click the Root of the scale device you want to control.
Relink resends the last key received and relinks the two
devices.
Deploy a different key from the one the scale device has to initialize the set up. Use one Deployer per
scale device. They all receive the same key, so several can follow at once.
The scale device shows as controlled. While the Deployer is linked, Root and the
scale type are driven by the device, the way a Macro drives a mapped control. Switch the Deployer to Manual
Mode and unmap, or remove it, to get the controls back.
Deployer and Scale Mapper · 21
CE SCALE MAPPER
Drives devices that have no scale awareness from a scale device.
Many useful devices take a pitch or a Macro rather than a scale: Pitch, a sampler's transpose, a rack
Macro. The Mapper watches a scale device and converts its Root into whatever those devices want.
- Map to Scale Base: click Map, then click the Root of the scale device that leads. This is
usually the scale device your Deployer drives.
- Map to Pitch/Base: click Map, then click the control to be driven.
- Pick the parameter type, then set the Mode range.
| Pitch Device | Sends semitones straight to a Pitch device. |
| Pitch (Macro) | Same semitones, scaled to a Macro that drives a pitch control. |
| Scale/Key | Sends the root to another scale device's Root. |
| Manual Macro | Semitones scaled into a range you set with Min and Max. |
Mode sets which roots pitch up and which pitch down. At -5st/+6st nothing moves more
than half an octave, so samples stay close to their recorded pitch. The scale types add Link Scale
Modes, so minor follows minor, and List Offset for devices that order their modes
differently.
Reference · 22
Troubleshooting
Quick fixes.
- CE DJ SYNC never shows Connected (Traktor)
- Check the D2 folder was replaced and a Kontrol D2 is in Traktor's Controller Manager, then click
Reconnect in Settings. Use only one CE DJ SYNC per Set. If another app uses port 64100, change the port in
ApiClient.js and in Settings to the same new number.
- CE DJ SYNC never shows Connected (CDJs)
- The Mac must be on the same network as the players, through the same switch or router, with Pro DJ Link
working between the players.
- The LINK chip stays orange
- Open CE DJ SYNC's Settings and read the line under Latency. Turn on Link in Live's control bar, make one
player tempo master, and press play on it. If it says UDP 50001 is taken, quit rekordbox or Beat Link
Trigger.
- CE DJ DECK says CE DJ SYNC not found
- Add CE DJ SYNC to the Set. The audio still works without it, but the display and deploys need it.
- Sample rates differ
- Set Traktor (Preferences → Audio Setup) or the mixer to the sample rate in Live → Settings → Audio.
- macOS won't open the Bridge installer
- The beta installer isn't signed by Apple yet. Allow it in System Settings → Privacy & Security →
Open Anyway, as in Download and install.
- CE HYBRID DJ Bridge not installed
- Run the Bridge installer, then restart Live.
- Waiting for audio, or the track is silent
- Check that Traktor's Audio Device is CE HYBRID DJ Bridge, Mixing Mode is External, and the deck is
routed to its pair. Check that Live has microphone access in System Settings → Privacy & Security →
Microphone.
- Input not connected, or No channels at that pair
- The device chosen in CE DJ DECK's Input menu is unplugged, or has fewer channels. Plug it in or choose
another pair.
- Keys arrive but Live does not change
- In Manual, keys wait for Deploy or a deck letter. In Auto, Key Cue needs a cue named KEY, and a Count In
longer than None needs Live's transport running. Global Scale needs Global Scale Awareness enabled in
Live.
- One deck never auto deploys from CE DJ SYNC
- Look for a purple DECK chip next to it. A CE DJ DECK in Manual or Auto deploys that deck instead.
- The scale device does not follow the Deployer
- In Auto Mode, place the scale device directly after the Deployer and click Relink. Then deploy a
different key from the one it has.
If you encounter any issues, have feature requests or just want to say hi, please email
alex@cloverdalestudio.com.