Skip to content

Commit

Permalink
Improve formatting, use labels, fix image size and add a warning note
Browse files Browse the repository at this point in the history
  • Loading branch information
@djantti
djantti committed Dec 9, 2023
1 parent 1e25c74 commit 195d155
Showing 1 changed file with 32 additions and 23 deletions.
55 changes: 32 additions & 23 deletions source/hardware/controllers/native_instruments_traktor_kontrol_z1.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,27 +11,36 @@ Native Instruments Traktor Kontrol Z1 is a two-deck ultra-compact DJ controller
Compatibility
~~~~~~~~~~~~~

The Kontrol Z1 is a HID and USB audio class compliant device, which makes it fully compatible with Mixxx. It requires no proprietary drivers when used on Linux or macOS. For Windows, download and install the latest driver from the `manufacturer's website <https://www.native-instruments.com/en/support/downloads/drivers-other-files/>`__.
The Kontrol Z1 is a HID and USB audio class compliant device, which makes it fully compatible with Mixxx. It requires no proprietary drivers when used on Linux or macOS.

For Windows, download and install the latest Traktor Kontrol Z1 audio driver from the `manufacturer's website <https://www.native-instruments.com/en/support/downloads/drivers-other-files/>`__.

.. warning::
**Parallel installation of Traktor Pro software on Windows**

If you have a parallel installation of Traktor Pro on Windows, a service called :file:`NIHardwareService.exe` is running in the background, which has control over the LEDs of the Z1.

To make the Z1 work properly with Mixxx, you must either uninstall the Traktor Pro software, or temporarily stop this Windows service. One way to do this is to open a Windows PowerShell terminal as Administrator, and run the following command: ``Stop-Service -Name "NIHardwareService"``.

Audio hardware setup
~~~~~~~~~~~~~~~~~~~~

The Z1 has a standard 4-channel sound card. Configure the channels in Mixxx as follows:

============ =====================
Audio output Channel configuration
============ =====================
Main Channel 1-2
Headphones Channel 3-4
============ =====================
======================= =======================
Audio output Channel configuration
======================= =======================
:guilabel:`Main` Channel 1-2
:guilabel:`Headphones` Channel 3-4
======================= =======================

Controller overview
~~~~~~~~~~~~~~~~~~~

.. figure:: ../../_static/controllers/native_instruments_traktor_kontrol_z1.png
:align: center
:width: 65%
:figwidth: 65%
:width: 85%
:figwidth: 85%
:alt: Native Instruments Traktor Kontrol Z1 (schematic view)
:figclass: pretty-figures

Expand All @@ -40,23 +49,23 @@ Controller overview
Mapping description
~~~~~~~~~~~~~~~~~~~

All knobs and buttons function in Mixxx as they are labeled and follow the manufacturer's standard mapping. Two extra track control functions are also available using the Mode button as a modifier. This makes the Kontrol Z1 more usable by itself without other controllers.
All knobs and buttons function in Mixxx as they are labeled and follow the manufacturer's standard mapping. Two secondary track control functions are also available using the :hwlabel:`Mode` button as a modifier. This makes the Kontrol Z1 more usable by itself without other controllers.

====== ==================================== ================================================================================== ==============================================================
No. Element Primary function Secondary function (+ Mode)
No. Element Primary function Secondary function
====== ==================================== ================================================================================== ==============================================================
1 Main knob Main output volume (hardware function - not mapped in Mixxx)
2 Cue Vol knob Headphone output volume (hardware function - not mapped in Mixxx)
3 Cue Mix knob Adjusts cue / main mix for the headphone output
4 Gain knob Adjusts pre-fader gain of the deck
5 Hi knob High frequency equalizer knob
6 Mid knob Middle frequency equalizer knob
7 Low knob Low frequency equalizer knob
8 Filter / FX knob Adjusts quick effect superknob for the deck
9 Filter / FX On button Toggles selected deck quick effect on / off Start / stop track playback
10 Headphone button Toggles deck headphone cueing on / off Seek track to cue and stop
11 :hwlabel:`Mode` button Activates secondary functions when pressed
12 VU meters Show the current instantaneous deck volume
1 :hwlabel:`Main` knob Main output volume (hardware function - not mapped in Mixxx)
2 :hwlabel:`Cue Vol` knob Headphone output volume (hardware function - not mapped in Mixxx)
3 :hwlabel:`Cue Mix` knob Adjusts cue / main mix for the headphone output
4 :hwlabel:`Gain` knobs Adjusts pre-fader gain of the deck
5 :hwlabel:`Hi` knobs High frequency equalizer knob
6 :hwlabel:`Mid` knobs Middle frequency equalizer knob
7 :hwlabel:`Low` knobs Low frequency equalizer knob
8 :hwlabel:`Filter | FX` knobs Adjusts quick effect superknob for the deck
9 :hwlabel:`Filter | FX On` buttons Toggles selected deck quick effect on / off Start / stop track playback
10 :hwlabel:`Headphone A / B` buttons Toggles deck headphone cueing on / off Seek track to cue and stop
11 :hwlabel:`Mode` button Activates secondary functions when held down
12 :hwlabel:`Level A / B` meters Show the current instantaneous deck volume
13 Volume faders Adjusts channel volume fader for the corresponding deck
14 Crossfader Adjusts the crossfader between both decks
====== ==================================== ================================================================================== ==============================================================

0 comments on commit 195d155

Please sign in to comment.