diff --git a/source/_static/controllers/native_instruments_traktor_kontrol_z2.svg b/source/_static/controllers/native_instruments_traktor_kontrol_z2.svg new file mode 100644 index 0000000000..69a6c43f06 --- /dev/null +++ b/source/_static/controllers/native_instruments_traktor_kontrol_z2.svg @@ -0,0 +1,2 @@ + +TRAKTOR KONTROL Z21234FLUXONCA1234FLUXONBDSHIFTAAABBBAB2121SQACMSTDBXF REVERSE!132122145678910111314151617181920372223242829303132333435363839252627 diff --git a/source/_static/controllers/native_instruments_traktor_kontrol_z2_audio_routing.svg b/source/_static/controllers/native_instruments_traktor_kontrol_z2_audio_routing.svg new file mode 100644 index 0000000000..322c3a4dcd --- /dev/null +++ b/source/_static/controllers/native_instruments_traktor_kontrol_z2_audio_routing.svg @@ -0,0 +1,1410 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A + + + + + + D + + + + + + + + + + + + + + + + + + + + + D + + + + + + A + + + + + + + + + + + + + + + + + + + + + A + + + + + + D + + + + + + + + + + + + + + + + + + + + + A + + + + + + D + + + + + + + + + Gain + + + + + + + + EQ + + + + + + + + Gain + + + + + + + + EQ + + + + + + + + LF + + + + + + + + Gain + + + + + + + + EQ + + + + + + + + LF + + + + + + + + CF + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Output Ch 1/2 + + + + + + + + + + + + + Main + + + + + + Input Ch1/2 + + + + + + Input Ch 3/4 + + + + + + Input Ch 5/6 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Head-phone + + + + + + + + + + + + + Input Ch 7/8 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Output Ch 3/4 + + + + + + + + Mixxx + + + + + + A + + + + + + Ph + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Ln + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Ph + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Ln + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + B + + + + + + Mic + + + + + + Mic/Aux + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Aux + + + + + + + + + + + + + + + + + + + Mono + + + + + + Stereo + + + + + + Booth + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SHIFT + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A + + + + + + B + + + + + + + + MasterGain + + + + + + + + + + + + + + + BoothGain + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A + + + + + + + + + + + + + + + + + + + + B + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + If a channel is in Internal Mixing mode, there is no signal on it‘s orange section + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/source/chapters/user_interface.rst b/source/chapters/user_interface.rst index 7831f47665..66f05b4be2 100644 --- a/source/chapters/user_interface.rst +++ b/source/chapters/user_interface.rst @@ -525,6 +525,8 @@ section. This button enables :term:`vinyl control`. When enabled in Mixxx, the track on the Mixxx deck is controlled by the external vinyl control. +.. _interface-passthrough: + **Pass button** This button enables passthrough. When enabled, audio from an external vinyl diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_z2.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_z2.rst new file mode 100644 index 0000000000..c6e5dc02be --- /dev/null +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_z2.rst @@ -0,0 +1,124 @@ +Native Instruments Traktor Kontrol Z2 +===================================== + +.. sectionauthor:: + Jörg Wartenberg + + +The Native Instruments Traktor Kontrol Z2 is a 2+2 channel USB :term:`HID` mixer/controller with an integrated audio interface. +It has two full channels and two further channels with limited controls +The Traktor Z2 is intended for a DVS systems and is provided with Traktor Scratch MK2 :term:`timecode` Vinyls and CDs. + +- `Manufacturer’s product page `__ +- `Virtual DJ Hardware Page `__ +- `Traktor Kontrol Z2 Manual (ZIP-file) `__ +- `Driver/Firmware-Updates Download Page `__ + +.. versionadded:: 2.4.0 + +Drivers +------- + +You can download the latest Windows & MacOS drivers and firmware from the `manufacturer’s website `__. +Since the Traktor Kontrol Z2 is a USB class compliant HID and audio device, the device is plug-and-play on Linux. + +.. warning:: + **Parallel installation of Traktor software on Windows** + If you have a parallel installation of Traktor on Windows, there will be a :file:`NIHardwareService.exe` process that takes control of the Traktor Kontrol Z2's LEDs. + To make the them work reliable with Mixxx, you either need to uninstall the Traktor software, or stop the process by opening the task manager, selecting :guilabel:`Show processes from all users` and kill the :file:`NIHardwareService.exe` process. + +Audio Setup +----------- + +.. figure:: ../../_static/controllers/native_instruments_traktor_kontrol_z2_audio_routing.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: Native Instruments Traktor Z2 (schematic view) + :figclass: pretty-figures + +The mapping relies on the following channel assignments: + +===================== ================ +Output Channels Assigned to +===================== ================ +1-2 Master +3-4 Headphones +===================== ================ + +===================== ================ +Input Channels Assigned to +===================== ================ +1-2 (Mic/Aux) Auxiliary 1 +3-4 (CH 1 Line/Phono) Vinyl Control 1 +5-6 (CH 2 Line/Phono) Vinyl Control 2 +7-8 (Recording) Record/Broadcast +===================== ================ + +The mono microphone input and the stereo auxiliary input are mixed with each other in the hardware together in input channels 1-2, so Mixxx can record and broadcast them. + +The knobs for :hwlabel:`MASTER`, :hwlabel:`BOOTH`, :hwlabel:`HP VOLUME` are controlling the hardware mixer of the built-in audio interface. +Hence, turning the knobs will not change values in the Mixxx :term:`GUI` and you’ll need to set the Mixxx knobs to their default values when using the controller: + +- Set the master/booth/headphones levels to 100% (knob center position) +- Set cue/master mixing to cue-only (leftmost position) + +.. note:: + You should assign the :guilabel:`Vinyl Control` input channels even if you do not intend to use timecode vinyl. + +Controls +-------- + +.. figure:: ../../_static/controllers/native_instruments_traktor_kontrol_z2.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: Native Instruments Traktor Z2 (schematic view) + :figclass: pretty-figures + +Mixer mode (Computer Internal vs. Direct mixer hardware) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The Traktor Z2 allows not only mixing using the mixer hardware directly, but also mixing internal in the software of the connected computer. + +Unique to the Traktor Z2 is, that the mixer mode can be switched per channel. This allows the user to connect another computer and starting Mixxx, while playing a track from an analog source in direct mode, and than blend over seamless to another channel in Internal mixing mode controlled by Mixxx. + +The mixing mode of channel A and B is controlled by the two buttons with the Traktor symbol on top: + +====================================== ================== ========================================== ==================================================== +Traktor button state Traktor button LED Action Behavior + +====================================== ================== ========================================== ==================================================== +Direct hardware mixing Off Press :hwlabel:`Traktor` to toggle Only Gain, EQ, Filter and Fader of channel operation (works without computer) +Computer Internal mixing (Passthrough) Dimmed :hwlabel:`SHIFT` hold + :hwlabel:`Traktor` Mixxx mixes the signal, but the channel is set to :ref:`Passthrough `. Similar to direct mode, but allows the use of features like software effects. +Computer Internal mixing Bright Press :hwlabel:`Traktor` to toggle Mixxx plays the track and mixes the signal internally. +====================================== ================== ========================================== ==================================================== + +.. note:: + The selection of the mixing mode is a hardware function overruling the software. Only if all channels are switched to computer Internal mixing, you've all features of Mixxx available! + +Shift button states +~~~~~~~~~~~~~~~~~~~ + +============================== ================ ==================================================== +Shift button state Shift button LED Action +============================== ================ ==================================================== +Unshifted Off +Shift hold Bright Press and hold :hwlabel:`SHIFT` +Shift locked Dimmed Short click on :hwlabel:`SHIFT` to toggle lock state +============================== ================ ==================================================== + +Browse Section +~~~~~~~~~~~~~~ + + Native Instruments Traktor Kontrol Z2 (Browse section) + +======== ============================================================= ========================================== +No. Control Function +======== ============================================================= ========================================== +1 :hwlabel:`LOAD/DUPLICATE A` (left) button Load song into deck A. +2 :hwlabel:`LOAD/DUPLICATE B` (right) button Load song into deck B. +3 :hwlabel:`SHIFT` + :hwlabel:`LOAD/DUPLICATE A` (left) button Duplicate track and play position from deck B to A +4 :hwlabel:`SHIFT` + :hwlabel:`LOAD/DUPLICATE B` (right) button Duplicate track and play position from deck A to B +5 Rotary Selector Turn to move tracklist cursor up/down. Press to toggle the selected item. +6 :hwlabel:`SHIFT` + Rotary Selector Turn to move sidebar cursor left right/down. +======== ============================================================= ==========================================