BOME+Traktor installation guide

for Pioneer DDJ controllers

Installation video: https://youtu.be/MbGP_ECnWiQ
Installation pdf: https://bit.ly/351FtCe
NOTE #1: There is several pdf documents and videos to learn this mapping.
For an overview, see page 3.
NOTE #2: There are several mapping versions: Free/paid, and with/without BOME.
For a comparison, see page 4.
NOTE #3: There are optional costs involved. However everything can be tested for free.
For a breakdown, see page 5.
NOTE #4: the Zip file contains the free and demo versions. To buy the full version, send an email to
[email protected].

NOTE #5: This guide is a companion to the step-by-step video. It covers all Pioneer DDJ controllers, both Windows and Mac.
Only difference is Aliases (page 18) and Output (page 37). See the annexes for other DDJs instructions (page 53).
NOTE #6: There are 3 files to install: a) settings for BOME (page 16); b) mapping for BOME (page 17); c) mapping for Traktor (page 24). The bome settings may
have issues on macOS. The Traktor mapping must be imported twice . Do not configure “DDJ-XXX” in the controller manager (page 35)!
NOTE #7: Issues? Reconfirm all steps of this guide and the step-by-step video. See also the FAQ in a separate pdf.
See also the “gotchas” (page 44). I also offer a remote help service (page 46).
1
INDEX:

Step #0 Confirm Rekordbox works

Step #1 Download the Zip file from DJ TechTools
Step #2 Install the Bome trial
Step #3 Install the Bome mapping
Step #4 Install the Traktor mapping
Step #5 TroubleShooting + Remote help

Annex A Stability / Restarts / Firmware bugs

Annex B Specific info for sx2/sz/srt/800, xdj-xz

2
WHICH VERSION TO CHOOSE? (DDJ-1000)
Normal BOME Idea
Installation Easy Complex
Preferences window 10s 2s

Bome required?
Jog Screens DDJ-1000SRT

Basic features Any map

7x JogFX DJTT Maps
21x PadFX, Slicer Rekordbox
Smooth Echo S11
Dual Deck S11
Polyrhythmic loops CDJ-3000
16x Filters RMX-1000
Resonant filter DJM-900
STEMS S4 MK3
Remix decks S4 MK3
Pattern Recorder S4 MK3
Tempo enlarger Rekordbox
Tone Play Pitch’n’Play
TurnTable break CDJs
Loop jog adjust CDJs
3
 HOW TO TEST THE MAPPING FOR FREE
The mapping is free. To try it, just download the traktor demo and
the bome demo. Only limitation is a 30 minutes time limit

FREE MAPPING TRAKTOR DEMO BOME DEMO

https://www.native-instruments.com/en/products/
https://maps.djtechtools.com/mappings/9279 traktor/dj-software/traktor-pro-3/demo-and-downloads/ https://www.bome.com/products/miditranslator

4
V7 OPTIONAL COSTS
Item Cost Recipient Reason Can I skip this cost?
BOME 60 eur BOME Necessary to break Yes. Use 6.3.3 instead
license Traktor limitations
Remote 30 eur DJ Estrela Hands-on work Yes. See my step-by-step
Install 60-page guide and 20-min video
Training 30 eur DJ Estrela Hands-on work Yes. See my 70-page manual and
step-by-step 90-min video

5
HOW TO LEARN THIS MAPPING

Installation guide (50 pages) FAQ (6 pages) Step-by-step video (20 min)

Quick Start (8 pages) Manual (80 slides) Detailed video (90 min) Full Reference (5 pages)

Link to Documentation PDFs: https://bit.ly/2M5ZemX

Link to Videos: https://www.youtube.com/user/djestrela2
Link to Survey: https://forms.gle/cf8kqpr91HHxMJcn8 6
 MAIN MAP LIMITATIONS
Limitation Reason Workaround
No Big Sur • Not tested • Use Catalina / Windows

Slow Scratching • Impossible in MIDI • This is enough for non-turntablists

No waveforms • Impossible in MIDI • Serato-like screens have all the basics
No Pioneer FX • HW limitation • Per USB-channel FX was replaced with
per USB channels Traktor effects (in some cases better)
• Analog sources (not DVS) have
Pioneer FX

Complex • BOME is required • 61-page step-by-step PDF

installation • 20-minute video
• Remote installation help (30 eur)
Extra costs • Bome is 3rd party • Everything can be tested for free via
required package the bome trial

7
WHICH VERSION TO CHOOSE? (OTHER DDJs)
2012 V0.6 (SX1)

2014 V1.3 (SX2)

Author: JaJa/ Viper 2015 V5.2 (SZ)

Author: DJ Estrela 2018 V6.1 (SZ/SX2) V6.1 (1000SRT) V6.1 (XDJ-XZ)

2019 2019

Traktor only
2019 V6.3 (1000)

BOME required 2020 V6.6 (1000) V6.7 (SZ/SX2)

2020

2021 V7.4 (1000)

(the blue boxes identify the best version for each controller)
8
 Step #0
CONFIRM THAT REKORDBOX
PERFORMANCE MODE WORKS
PROPERLY IN YOUR SYSTEM!!
Driver Download: https://www.pioneerdj.com/en/support/software/controller/ddj-1000/#drivers
Firmware download: https://www.pioneerdj.com/en/support/software/controller/ddj-1000/#firmware-update
Rekordbox DJ download: https://rekordbox.com/en/
VirtualDJ Instructions (for reference): https://www.virtualdj.com/manuals/hardware/pioneer/ddj1000/installation.html

9
 Step #1
DOWNLOAD THE MAPPING

To download NEED to first register and then login in the DJTT site.

If it still fails, clear your cookies and use another browser.

5K persons have downloaded this mapping since Feb 2019.

DDJ-1000/800: https://maps.djtechtools.com/mappings/9279
DDJ-SX2/SZ/SRT: https://maps.djtechtools.com/mappings/9222
XDJ-XZ: https://maps.djtechtools.com/mappings/10305

1
0
1: CREATE AN ACCOUNT ON DJTECHTOOLS:
https://my.djtechtools.com/users/sign_up

2
3

4
11
2: SIGN-IN ON YOUR ACCOUNT:
https://my.djtechtools.com/users/sign_in

2
3

12
3: DOWNLOAD THE MAPPING

DDJ-1000/800: https://maps.djtechtools.com/mappings/9279
DDJ-SX2/SZ/SRT: https://maps.djtechtools.com/mappings/9222
XDJ-XZ: https://maps.djtechtools.com/mappings/10305

13
 Step #2
BOME TRIAL:
SOFTWARE INSTALLATION

Note: the bome trial cannot be activated to make it full.

If you buy a license you will need to re-download it from your account instead.

14
BOME INSTALLATION - TRIAL:
1. Download and install the BOME trial from:
https://www.bome.com/products/miditranslator#downloads

15
BOME INSTALLATION - FULL:
1. Uninstall the BOME trial first!

2. Create an account on the BOME site, validate your email

3. Login and Buy the “BOME midi translator PRO” (cost: 60 eur)
4. Download and install the FULL version from your account page:
https://www.bome.com/account#products
5. Copy/paste the whole license text when asked in BOME

3
2
16
MAC-OS SECURITY ENABLE:
1. macOS 10.9 and later:
1. System Preferences → Security & Privacy → Privacy → Accessibility -> Add “BOME”
2. macOS 10.8 and earlier:
1. System Preferences → Universal Access → check 'access for assistive devices‘

3. More info: See Page 40 of the BOME manual

https://www.bome.com/bome/downloads/manuals/miditranslator_manual.pdf
https://www.maketecheasier.com/macos-security-privacy-permissions/

1
2

BOME
5

4
17
 Step #3a
BOME MAPPING: INSTALLATION

1
8
PRELIMINARIES:
1. Stop Rekordbox
2. Stop Traktor
3. Expand all files in the zip file
4. Connect the USB cable
5. Turn on your DDJ

INSTALLING BOME MAPPING:

1. Open BOME. DO NOT RUN TRAKTOR!

2. Settings: Import the settings file

1. Method: menu View; settings; export/import; import; select BMTS file

3. Mapping: load the mapping file

1. Method: Click menu File; Open; select BMTP file

4. Do not mix up the Settings file with the Mapping file! Beware!

1
9
BOME: import settings file (BMTS file)

3
2

MANUAL STEP: Auto start with Windows/MAC needs to be set by hand!

This is a bome bug 2
0
BOME: import mapping file (BMTP file)

(Example for DDJ-1000; other DDJ are similar. See annexes for details) 2
1
BOME: Aliases (DDJ-1000 case)
Do exactly this

IMPORTANT: THESE SETTINGS CHANGED IN V7.0!!!

WE NOW USE 2x VIRTUAL DEVICES
22
BOME: Aliases (XDJ-XZ case)
Do exactly this

XDJ-XZ (1)
XDJ-XZ (1)

XDJ-XZ (2)
XDJ-XZ (2)

23
BOME: Devices

Confirm this “cross” on EXACTLY these aliases

(Example for DDJ-1000; other DDJ are similar. See annexes for details)
24
 Step #3b
BOME MAPPING: VERIFICATION
Important: do these steps WITHOUT traktor running.
Reason: the denon HC-4500 map sends A LOT of data to the log.

25
BOME VERIFICATION STEPS:
1. Confirm the “Bome MIDI Translator 1” device is created (longformat)
1. Method: menu View ; settings ; virtual midi ports ; 1 port; long port names

2. Confirm the 5x midi ports were opened correctly

1. Method: Click log window; check log

3. Confirm that the Controller talks to BOME

1. Method: Click log window; click “MIDI-IN/OUT”; Press any button on the
controller; confirm they appear in the log file; unclick “MIDI-IN/OUT”

4. Confirm that the BOME clock is running

1. Method: Click log window; click “rules”; see a lot of messages appearing
2. unclick “rules” to stop the logging

5. Minimize BOME to keep it running

26
BOME settings: auto start with windows

Auto start with

2 Windows/MAC needs
to be set by hand!

27
BOME settings: long port name device

2x ports in v7.0;
in v6.8 it was 1x port only!

3 Long port names!

2
4

IMPORTANT: THESE SETTINGS CHANGED IN V7.0!!!

WE NOW USE 2x VIRTUAL DEVICES
28
BOME: Correct startup log
Do not change this!

Default is ONLY 1
- “From Traktor” OPEN
- “to DDJ” OPEN

confirm devices are OPEN!

2
4
4x messages here!

Do not change this

5 “cross”!

(Example for DDJ-1000; other DDJ are similar. See annexes for details)
29
BOME: confirm DDJ talks to BOME

1 Pressing and releasing any

button generates 4 log
lines. This is always in the
DDJ->BMT1 direction
3

Activate MIDI debug here

2
(Example for DDJ-1000; other DDJ are similar. See annexes for details)

30
BOME: confirm internal clock

1
HZ goes up
3 one by one continuously

Activate rules debug here

(Please click “rules” again to stop the logging) Tip!

31
 Step #4a
TRAKTOR MAPPING: INSTALLATION

32
CREATE A BACKUP:
1. Note: the mapping replaces a lot of your settings. In any cases, Traktor
always makes automatic backups in “Root_Dir\Backup\Settings”

1. Open Traktor
2. Click Settings
3. Click big “export button” on lower left corner
4. Ensure all settings are clicked
5. Save the file

INSTALL TRAKTOR MAPPING:

1. Click Settings
2. Click big “import button” on lower left corner
3. Accept all checks; PLUS additionally click the “Audio device settings” Extra click!

INSTALL TRAKTOR MAPPING (second time):

1. Repeat above process a second time. This is only to avoid a Traktor bug that
gets the FX list wrong.

MAC-OS AUDIO OUTPUT ROUTING:

1. Set preferences / Output Routing / Internal to: 2 / 3 / 0 / 1

33
TRAKTOR: create backup of your settings

Backup everything!

2
34
TRAKTOR: import mapping

Please include this

audio device as well

3 4

(Example for DDJ-1000; other DDJ are similar. See annexes for details)

35
TRAKTOR: import mapping (second time!)

(Example for DDJ-1000; other DDJ are similar. See annexes for details)
36
 Step #4b
TRAKTOR MAPPING: VERIFICATION

37
TRAKTOR VERIFICATION:
Note: the Preferences window is now quite slow to open. This is another Traktor bug.

1. Confirm the audio device is “DDJ-1000” / “DDJ-SZ” / etc

1. Method: Settings ; audio setup ; confirm audio device

2. Confirm the Output routing

1. Method: Settings ; output routing; confirm “internal”; confirm “3 / 4 / 1 / 2”
2. (see annexes for other DDJs case)

3. Confirm that all 3x pages have exactly “Bome Midi Translator1” or “2”
1. Method: Settings; controller manager; click each of the 3x pages one-by-one; check IN and
OUT port
2. DO NOT CHANGE TO DDJ-1000 in the controller manager!!! Beware #1!
3. DO NOT FORGET TO CONFIRM ALL 3x PAGES! Beware #2!

4. Verify that sound is played

1. Method: Load a track; click Cue and play/pause repeatedly
2. Use shift+quantize to send a reset command to BOME

5. Verify that BOME sees all the messages

1. Method: open the bome window; click the “CUE” button; verify that the BOME log displays
at least 8x log lines per human click

38
TRAKTOR: Audio Setup
WINDOWS MAC

1 1 2
2

(Example for DDJ-1000; other DDJ are similar. See annexes for details)

39
TRAKTOR: Output Routing
Important: the below pictures are for DDJ-1000 (internal mode);
Some DDJs run in external mode instead (see annexes)

Windows: channels are MacOS: channels

3/4/1/2 are 2 / 3 / 0 / 1

1 2 1 2
3 3

40
TRAKTOR: Input Routing

WINDOWS MAC

1 1

2 2

(Example for DDJ-1000; other DDJ are similar, but DDJ-SZ is different. See annexes for details)

41
TRAKTOR: Mix Recorder

WINDOWS MAC

2 2

1 1

(Example for DDJ-1000; other DDJ are similar. See annexes for details)

42
TRAKTOR: check MIDI device is long format
First 2x pages with virtual device #1, IN+OUT
first click here
HC4500 page with virtual device #2, OUT only

2 3

IMPORTANT: THESE SETTINGS CHANGED IN V7.0!!!

WE NOW USE 2x VIRTUAL DEVICES
43
BOME: confirm bidirectional flow

1
Pressing and releasing any
button generates at least 8x
log lines.
This is both in the DDJ-
4 >BMT1 direction and the
BMT1->DDJ direction

2
3
Stop “rules” log

44
 Step #5a
PROPER START SEQUENCE

45
PROPER START-UP SEQUENCE IF YOU HAVE PROBLEMS:

1. Stop everything

2. Start Laptop
3. Start BOME
4. Start your DDJ
5. Start Traktor

46
If you get a “Pending device Error” in BOME, reconfirm you are NOT opening the DDJ-1000
device in traktor.
In this case, just reinstall the TSI again.

Never do this!!

47
 IF ITS STILL NOT
WORKING #1
A) AUDIO doesn’t work:
Re-confirm the DDJ-1000 is your audio device
Re-confirm output routing is 3/4/1/2 in windows and 2/3/0/1 in macOS
Re-confirm Rekordbox performance mode works

B) AUDIO works - but buttons doesn’t :

Re-confirm you have BOME in the macOS accessibly security
Re-confirm you have “Bome midi Translator 1” on the 2x pages in Traktor
Check if any device is in “error state” in BOME
Restart BOME (toggle red button on upper right corner)

C) The buttons work, but the lights / jog screens dont:

Reset the jog Screens using shift+quantize
Restart BOME (toggle red button on upper right corner)
Restart components in this order: #1 Laptop / #2 BOME / #3 DDJ / #4 Traktor

D) (v7.0 only) Jog screens work, but timestamp doesn’t go up:

Ensure you have 2x virtual bome devices, and HC4500 points to BMT#2
Deck 3 and 4 lack this feature at the moment
48
IF ITS STILL NOT
WORKING #2
For a small fee I will install this mapping remotely for you.
Interested? send an email to [email protected]

49
ANNEXES

50
 ANNEX:
REMOTE HELP WITH A
WETRANSFER VIDEO

51
HD VIDEO RECORDING:
I may ask you to record a video of your issue if I don’t understand it.
In this case follow these steps:

1. Preparation:
1. Find a repeatable method to trigger the issue
2. Only use Loops as the music source
3. Turn on the lights of your room
4. Always record in high definition

2. Demonstration:
1. Use landscape mode
2. Point your camera to the controller and then to the screen to show me specific things.
3. Be sure that I can see the whole screen.
4. Make the video as long as necessary for me to see the issue clearly.

3. If you need to use two hands:

1. drop the camera in the table for that operation

4. Post processing:
1. Upload the HD video to http://wetransfer.com
2. Send me the link to [email protected]

52
 ANNEX:
REMOTE HELP WITH
TEAMVIEWER

53
TEAMVIEWER SOFTWARE INSTALLATION:
1. Teamviewer is a free way to remote control
2. Its also very simple. No login needed.
3. Download link:
1. https://www.teamviewer.com/en/download/mac-os/
2. https://www.teamviewer.com/en/download/windows/

3
54
TEAMVIEWER OLD VERSION:
If you have MacOS Sierra 10.12.6, install v13 instead:
https://download.teamviewer.com/download/version_13x/TeamViewer.dmg

Then, update it by clicking “Help” / “Check for new version”

55
MAC-OS SECURITY ENABLE:
1. macOS 10.9 and later:
1. System Preferences → Security & Privacy → Privacy → Accessibility -> Add “Teamviwer”
2. macOS 10.8 and earlier:
1. System Preferences → Universal Access → check 'access for assistive devices‘

3. More info: https://community.teamviewer.com/t5/Knowledge-Base/How-to-control-a-Mac-

running-macOS-10-14-or-higher/ta-p/44699

1
Enable
2
these two!

1 5

3
4

56
TEAMVIEWER REMOTE CONTROL:
1. Run the software
2. Send me your teamviwer ID and password

1 2
3

57
VIDEO CALL:
1. Tell me which timezone you are. I’m in Western Europe.
1. Use this link: https://www.timeanddate.com/worldclock/meeting.html
2. Call me in Facebook messenger or WhatsApp
3. Show me the controller as exemplified below.
1. You will need both hands free to use shortcuts

58
 ANNEX:
STABILITY, RESTARTS
AND FIRMWARE BUGS

59
 .TSI
AUDIO path KERNEL
USB

(Mapping)
TRAKTOR
DRIVER

(HC-4500)

MIDI path
DDJ
BMT2 1000
BMT1

.BPTS
(Settings) BOME
.BMTP MIDI Translator
(Project)

60
DDJ-1000: Restart stability
What happens in the following situations, without doing any further manual work?
Audio? Midi Control? LEDs?
Stop Traktor Audio Stop Stops Stops
Start Traktor Needs manual start Starts by itself Starts by itself
To restart Bome:
Stop BOME Audio continues Stops Stops
Start BOME Audio continues Starts by itself Starts by itself

Power-off DDJ Audio stops Stops Stops Twice!

Power-on DDJ Continues where it Starts by itself Needs manual
was BOME restart

Remove USB cable (same) (same) (same)

Reconnect (same DDJ
port)

Remove USB cable (same) (same) (same)

Reconnect (diff. DDJ port)

UPDATE: future bome 1.8.5 will significantly improve this situation. Stay tuned.
61
DDJ-1000: forced MIDI mode

In my experience there is no need to set the unit to forced MIDI mode.

In particular there was no difference on the restart stability (see prev page).

If this is ever necessary, instructions are on page 26 of the DDJ-1000 manual:

• no USB cable
• power off DDJ
• Press left play + left shift + turn on DDJ
• left Slip Reverse:
– Off = auto mode
– ON = forced mode
• Power off DDJ
• Power ON DDJ
• insert USB cable.

62
DDJ firmware Bugs / Limitations
DDJ-1000:

Other:

Pioneer new ticket: https://forums.pioneerdj.com/hc/en-us/requests/new?ticket_form_id=72145

(clean your cookies and disable AddBlockPlus to use the Pioneer forum)

Serato new request: https://serato.com/forum/discussion/1736390 63

Traktor: 9x mixerFX
Changing 9x mixer FX is only supported for windows and TP3.3 or above
For mac a method also exists
More info: https://maps.djtechtools.com/mappings/10575

2
1

4 3
64
Traktor: Slowdowns
V7.3 improved significantly the performance on mac OS catalina
by avoiding back to back messages
Demo: https://www.youtube.com/watch?v=Us0gS__qR7c

The same issue happens in HID mode:

https://youtu.be/iB0viIkSXPg

65
 ANNEX:
SPECIFIC INFO FOR
SX2/SZ/SRT line of
controllers

66
WHICH VERSION TO CHOOSE (DDJ-SX2/SZ)
(future)

V6.1.7 BOME V6.7.2 TBD V7.X.X

• Easy to install • Complex install • TBD: a port of the

• No extra costs • 60 eur license DDJ-1000 v7 mapping
(for a third-party)
• Only basic features • Filter SuperKnobs
• Pad modes in front • Turntable FX
• Preview player • Resonant filter
• Beatjump buttons • STEMS
• Loop Jog adjust • Remix decks
• … • Tempo enlarger
• …
SX2/SZ has two versions: with/without BOME. The zip file includes both versions.
The BOME migration was essential to enable features that are impossible with Traktor alone;

in particular there is now a single unified mapping shared with the DDJ-1000.
In the future, this will enable to port the recoded v7.0 map to the SX2/SZ as well.
67
 ANNEX: DDJ-1000SRT (1)
DDJ-1000SRT specific instructions for the Traktor mapping (for v6.1.X – not yet updated to V6.7.0
BOME)

Please use the specific TSI for the DDJ-1000SRT. This is the same mapping as the DDJ-SZ
mapping, but with small customizations to make it work well on the SRT:

• Jog screens are NOT supported. This is because they are not documented on the Pioneer
MIDI map file. Please request this in https://serato.com/forum/discussion/1736390
• Please put your jog weight to “heavy”
• This will significantly improve scratching and jogFX
• Audio device in external mode.
• This means that ALL the pioneer effects (both colorFX and beatFX work for USB sources
• See next slides for config
• Please avoid VINYL OFF mode. The TSI disables jog touch in this case, but the jog loses
resolution compared to VINYL ON mode
• Beatjump buttons added. Please use shift+IN/OUT to configure the loop size (=jump size)
• BeatFX ON/OFF is now for pioneer beatFX only
• Automatic layout changing was removed

68
 ANNEX: DDJ-1000SRT (2)
(note: pictures are for v6.1.X; v6.7.0 will also work, but was not tested yet)

69
ANNEX: DDJ-SZ

SET PREVIEW TO
SAME VALUES
AS DECK 4!

70
 ANNEX: DDJ-SX2
(Select SX2 device here) (Put SX2 channels here)

71
 ANNEX: DDJ-SX3
(Select SX3 device here) (Select SX3 device here)

SET PREVIEW TO
SAME VALUES
AS DECK 4!
72
 ANNEX:
SPECIFIC INFO FOR 800,
XDJ-XZ, and XP line of
controllers

73
 ANNEX: DDJ-800
DDJ-800 specific notes:
- Firmware 1.01 (april 2019) has a bug that precludes using the jogs screens.
- This was reported and acknowledged by Pioneer.
https://www.pioneerdj.com/en-us/support/software/controller/ddj-800/

74
 ANNEX: XDJ-XZ (1/3)
Device Config: To link: press browse / press Link / press Load1+2

More info: See page 128 of the Pioneer Manual:

https://github.com/pestrela/music/blob/master/ddj/4%20Manuals/XDJ-XZ%20-%20Full%20Manual.pdf

XDJ-XZ features video:

https://www.youtube.com/watch?v=7EPfY9bGGlw&list=PLIlvTGzSxI0UV1oJfRDL4fYY9oRyLkBik&index=1

BOME installation video:

https://youtu.be/MbGP_ECnWiQ

75
 ANNEX: XDJ-XZ (2/3)
BOME aliases:

XDJ-XZ (1)
XDJ-XZ (1)
XDJ-XZ (2)
XDJ-XZ (2)

Proper BOME config: Proper BOME config: Proper BOME log:

76
 ANNEX: XDJ-XZ (3/3)
Traktor config:

77
XDJ-XZ “ghosting”
The XDJ-XZ firmware has a bug that sets to zero the least significant bit 7-bit of 14-bit
CC messages.

This means that randomly a “ghost needle” will appear at exactly:

- 0 degrees,
- 128 degrees,
- 256 degrees.

This is a known issue, and I believe its only possible to fix by Pioneer itself.

0 deg

128 deg

https://youtu.be/7EPfY9bGGlw?t=120
78
Performance: Messages in a row
The macOS DDJ-1000 kernel driver has poor performance when BOME/Traktor sends too many
messages in a row.

In Windows this is not a problem.

Same story for Bootcamp (running Windows in mac Intel hardware)

The latest version of the mapping explicitly shapes the messages, to avoid this issue.

79
 Mapping History
This mapping has many man-years of work combined.
It was derived from the famous JaJa/Viper mapping, that goes back to 2012.
Since 2012 it was both ported and back-ported between devices multiple times.

As of v6.5.0 it was forked to use BOME.

As of v6.7.0 it was merged back to a single unified mapping for all DDJs.
As of v7.0 the mapping was redone from scratch and is now donation only.

80
 Map Updates
Version Date Major features

V7.4 Feb 2021 Smooth Echo, dual deck, polyrhythmic loops

V7.3 Dec 2020 Catalina support, central pad configuration

V7.2 Nov 2020 Simplified usage, reordered pad modes, better performance

V7.1 Oct 2020 Reliability improvements, performance improvements

V7.0 June 2020 16x filters, STEMS, remix recorder, turntable break, tempo range

V6.6 Oct 2019 CDJ-like features, whole new pad modes

V6.5 Sep 2019 Jog Screen support, better scratching

81
 How popular is this mapping?
This mapping is one of the most popular of DJ TechTools.
It is also one of the youngest (2 years); All mappings on the top-5 have >8 years of history

#12 of all Traktor mappings

#1 of DDJ-1000 mappings #5 of Pioneer mappings

(…)

82
 Performance: Scratching
To improve scratching, lower the audio latency as much as possible, without
introducing audio artifacts (crackling)

Details: The MIDI firmware sends jog turn messages up that only range between -20..+20 points.
The MIDI resolution allows a range of -64..+63, so the hardware could send increased messages.

The above also means that groups of 3x DDJ messages can be coalesced into 1x message to Traktor without any accuracy loss. I’ve tried it,
and saw no difference in the scratching quality.

This experiment hints that the performance bottleneck is NOT Traktor, and it is either the kernel driver and/or the midi firmware.

MIDI velocity

Time (s)
83
 USEFUL URLs:
• DDJ-1000 survey: https://forms.gle/cf8kqpr91HHxMJcn8
• Bome clock values: http://shorturl.at/kmrLN

• Mappings download: https://my.djtechtools.com/users/830428

• Online documentation: https://github.com/pestrela/dj_maps

• Videos: https://www.youtube.com/user/djestrela2
• Support: [email protected]

84