Midi Mapping for Native Instruments Traktor Kontrol Z1 mixer

XML preset files and script files (.js) for MIDI and other controllers.

Moderators: garth, User Customization Moderators

Midi Mapping for Native Instruments Traktor Kontrol Z1 mixer

Postby bunda3d » Thu Aug 24, 2017 6:04 am

This xml document maps the basic functions of a Traktor Z1 2-channel mixer to Mixxx, Midi-style Not HID-style.

The Filter knobs have been mapped to the "Super Knob" filter effects on each deck. The lighted "on" button under the knob is not mapped to anything.

The Main Gain, Cue Gain, & Cue Balance knobs did not respond to Midi mapping.

If this document is out of compliance with generally accepted mapping practices, please address how it should be improved in forum comments here.

XML *.midi file attached, & main body of XML posted below.

Thanks
Kris

Code: Select all
   <controller id="NI Traktor Kontrol Z1">
        <scriptfiles>
            <file functionprefix="TZ1" filename="common-controller-scripts.js"/>
        </scriptfiles>
        <controls>
         <control>
                <group>[EqualizerRack1_[Channel1]_Effect1]</group>
                <key>parameter3</key>
                <description>Deck1: Adjust High EQ</description>
                <status>0xB0</status>
                <midino>0x01</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[EqualizerRack1_[Channel1]_Effect1]</group>
                <key>parameter2</key>
                <description>Deck1: Adjust Mid EQ</description>
                <status>0xB0</status>
                <midino>0x02</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[EqualizerRack1_[Channel1]_Effect1]</group>
                <key>parameter1</key>
                <description>Deck1: Adjust Low EQ</description>
                <status>0xB0</status>
                <midino>0x03</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[Channel1]</group>
                <key>pfl</key>
                <description>Deck1: Cue Headphone Switch</description>
                <status>0xB2</status>
                <midino>0x01</midino>
                <options>
                    <switch/>
                </options>
            </control>
            <control>
                <group>[Channel2]</group>
                <key>pfl</key>
                <description>Deck2: Cue Headphone Switch</description>
                <status>0xB2</status>
                <midino>0x02</midino>
                <options>
                    <switch/>
                </options>
            </control>           
            <control>
                <group>[Channel1]</group>
                <key>pregain</key>
                <description>Deck1: Gain</description>
                <status>0xB0</status>
                <midino>0x00</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[Channel2]</group>
                <key>pregain</key>
                <description>Deck2: Gain</description>
                <status>0xB1</status>
                <midino>0x00</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[EqualizerRack1_[Channel2]_Effect1]</group>
                <key>parameter3</key>
                <description>Deck2: Adjust High EQ</description>
                <status>0xB1</status>
                <midino>0x01</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[EqualizerRack1_[Channel2]_Effect1]</group>
                <key>parameter2</key>
                <description>Deck2: Adjust Mid EQ</description>
                <status>0xB1</status>
                <midino>0x02</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[EqualizerRack1_[Channel2]_Effect1]</group>
                <key>parameter1</key>
                <description>Deck2: Adjust Low EQ</description>
                <status>0xB1</status>
                <midino>0x03</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[QuickEffectRack1_[Channel1]]</group>
                <key>super1</key>
                <description>Deck1 Super Knob Filter Effect</description>
                <status>0xB0</status>
                <midino>0x04</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[QuickEffectRack1_[Channel2]]</group>
                <key>super1</key>
                <description>Deck2 Super Knob Filter Effect</description>
                <status>0xB1</status>
                <midino>0x04</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[Channel1]</group>
                <key>volume</key>
                <description>Deck1 Volume Slider</description>
                <status>0xB0</status>
                <midino>0x06</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[Channel2]</group>
                <key>volume</key>
                <description>Deck2 Volume Slider</description>
                <status>0xB1</status>
                <midino>0x06</midino>
                <options>
                    <normal/>
                </options>
            </control>
            <control>
                <group>[Master]</group>
                <key>crossfader</key>
                <description>Master Cross Fader</description>
                <status>0xB2</status>
                <midino>0x05</midino>
                <options>
                    <normal/>
                </options>
            </control>
        </controls>
    </controller>
</MixxxControllerPreset>
Attachments
Traktor-Kontrol-Z1.midi.xml
(6.42 KiB) Downloaded 530 times
bunda3d
 
Posts: 8
Joined: Thu Aug 24, 2017 5:42 am

Re: Midi Mapping for Native Instruments Traktor Kontrol Z1 m

Postby rimorob » Sun Jun 23, 2019 10:02 pm

When I download this into the "controllers" folder, mixxx dies because it doesn't like the <forums> tag. When I remove that tag, it starts fine, but fails to detect the controller. Is there supposed to be a javascript file with this?
rimorob
 
Posts: 85
Joined: Tue Jul 07, 2015 9:26 pm

Re: Midi Mapping for Native Instruments Traktor Kontrol Z1 m

Postby bunda3d » Fri Sep 06, 2019 11:39 pm

rimorob wrote:When I download this into the "controllers" folder, mixxx dies because it doesn't like the <forums> tag. When I remove that tag, it starts fine, but fails to detect the controller. Is there supposed to be a javascript file with this?


I'm not sure what happened, it works for me. I'm using Windows 10, and have downloaded the Traktor Control panel Z1 or whatever, which autostarts. If that's not running, mixxx does not understand that I have a controller, I think.
bunda3d
 
Posts: 8
Joined: Thu Aug 24, 2017 5:42 am

Re: Midi Mapping for Native Instruments Traktor Kontrol Z1 m

Postby bunda3d » Sun May 24, 2020 9:59 pm

rimorob wrote:When I download this into the "controllers" folder, mixxx dies because it doesn't like the <forums> tag. When I remove that tag, it starts fine, but fails to detect the controller. Is there supposed to be a javascript file with this?


Hi rimorob,

I had not had any issues with that XML file until I bought a new computer, and I see what you mean about the <forum> tag (it had an ampersand that didn't cause problems for me originally, maybe a newer version of Mixxx didn't like it?).

To fix the ampersand in the forum URL issue, surround the URL with a CDATA statement, as shown in this infographic:

cdata statement for problem ampersand in controller xml.png
cdata statement for problem ampersand in controller xml
cdata statement for problem ampersand in controller xml.png (269.75 KiB) Viewed 971 times


Or just replace the forum tag with this:
Code: Select all
<forums><![CDATA[https://www.mixxx.org/forums/viewtopic.php?f=7&t=9317]]></forums>


Also, I could not get my Traktor Z1 to work with my new machine until I installed and ran the Native Instruments "Controller Editor" software (located here: https://www.native-instruments.com/en/support/downloads/drivers-other-files/ "). I didn't actually create any new mapping document or anything, just opened the app and clicked around.

This is in addition to installing the appropriate Traktor Z1 Driver software, also on that page. I don't know why I needed the Controller Editor software to get things working--does it install a dependency that helps Mixxx map functions? I dunno, but wanted to report back on here for anyone in the same predicament.

Still, I did not have to write a custom *.js file for this to work, FYI.

***************************************
**EDITED to add: A person would still want to reference the "common" controller js file that is already referenced in the XML file. I store the XML file and the common-controller-scripts.js file [ATTACHED] in the app-data folder (for Windows) as so:

Code: Select all
C:\Users\YOUR_USER_ACCOUNT_NAME\AppData\Local\Mixxx\controllers


common-controller-scripts.js
common-controller-scripts.js
(16.59 KiB) Downloaded 106 times

Traktor-Kontrol-Z1.midi.xml
UPDATED XML file for Traktor Z1 (fixed forums tag)
(6.43 KiB) Downloaded 112 times
bunda3d
 
Posts: 8
Joined: Thu Aug 24, 2017 5:42 am

Re: Midi Mapping for Native Instruments Traktor Kontrol Z1 m

Postby Be. » Sun May 24, 2020 11:37 pm

Ampersands in XML should be
Code: Select all
&amp;
Mixxx is free because it's yours!

I heard FLAC and I haven't gone back.
Protect your hearing with earplugs!

Hear my mixes
User avatar
Be.
Mixxx Developer
 
Posts: 2573
Joined: Tue Jan 06, 2015 1:00 am
Location: Chicago, USA


Return to Controller presets/mappings

Who is online

Users browsing this forum: No registered users and 9 guests