diff --git a/source/_static/controllers/numark_ns6ii_schematics/display.svg b/source/_static/controllers/numark_ns6ii_schematics/display.svg new file mode 100644 index 0000000000..e614cda919 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/display.svg @@ -0,0 +1,2 @@ + +DECKPITCHKEYBPM%125467893 diff --git a/source/_static/controllers/numark_ns6ii_schematics/front_view.svg b/source/_static/controllers/numark_ns6ii_schematics/front_view.svg new file mode 100644 index 0000000000..11a2a304fa --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/front_view.svg @@ -0,0 +1,2 @@ + +MIC 1LOWHIGHLEVELMIC 2MIXSPLITGAINOFFONCUECFCONTOUR12356478 diff --git a/source/_static/controllers/numark_ns6ii_schematics/fx_unit.svg b/source/_static/controllers/numark_ns6ii_schematics/fx_unit.svg new file mode 100644 index 0000000000..cc58f3b05b --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/fx_unit.svg @@ -0,0 +1,2 @@ + +FX 1FX SELECTFX 2FX 3MODETAP42444345 diff --git a/source/_static/controllers/numark_ns6ii_schematics/mixer.svg b/source/_static/controllers/numark_ns6ii_schematics/mixer.svg new file mode 100644 index 0000000000..eec838ad96 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/mixer.svg @@ -0,0 +1,2 @@ + +LOADABMAXMINLOWMIDHIGHGAINLOHIFILTERCUEA OFF BN12MixerChannel13144711108974638 diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/auto_loop.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/auto_loop.svg new file mode 100644 index 0000000000..f04596e569 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/auto_loop.svg @@ -0,0 +1,2 @@ + +CUESLOOPSAMPLERSLICERCUE LOOPSSLICER LOOPROLLVELOCITYAUTO21PARAMETER ADJUST248163264128256ChangeLoopsize diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/beat_jump.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/beat_jump.svg new file mode 100644 index 0000000000..8e74a76052 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/beat_jump.svg @@ -0,0 +1,2 @@ + +AUTOCUESLOOPSAMPLERCUE LOOPSSLICER LOOPROLLVELOCITYSLICER21PARAMETER ADJUST1248-1-2-4-8ChangeJumpsize diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/beatgrid_settings.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/beatgrid_settings.svg new file mode 100644 index 0000000000..da40f3bcd1 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/beatgrid_settings.svg @@ -0,0 +1,2 @@ + +AUTOCUESLOOPSAMPLERSLICERCUE LOOPSROLLVELOCITYSLICER LOOP21PARAMETER ADJUSTSetBeatgrid@CursorBeatsTranslateEarlierBeatsTranslateLaterShiftCuesLaterGrid BPMTapBeatsAdjustFasterBeatsAdjustSlowerShiftCuesEarlierNoFunction diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/generic.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/generic.svg new file mode 100644 index 0000000000..042878bd36 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/generic.svg @@ -0,0 +1,2 @@ + +AUTOCUESLOOPSAMPLERSLICERCUE LOOPSSLICER LOOPROLLVELOCITY21PARAMETER ADJUST3231302928272626262626262626 diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/hotcues.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/hotcues.svg new file mode 100644 index 0000000000..be15103c13 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/hotcues.svg @@ -0,0 +1,2 @@ + +CUESCUE LOOPSSLICER LOOPROLLVELOCITYAUTOLOOPSAMPLERSLICER21PARAMETER ADJUST1/92/103/114/125/136/147/158/16No FunctionCycle Color diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/intro_outro.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/intro_outro.svg new file mode 100644 index 0000000000..fb8a71ddb0 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/intro_outro.svg @@ -0,0 +1,2 @@ + +AUTOCUESLOOPSAMPLERCUE LOOPSSLICER LOOPROLLVELOCITYSLICER21PARAMETER ADJUSTIntroStartIntroEndOutroStartIntroEndNo Function diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/key_control.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/key_control.svg new file mode 100644 index 0000000000..60254ee8c1 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/key_control.svg @@ -0,0 +1,2 @@ + +AUTOCUESSAMPLERSLICERCUE LOOPSSLICER LOOPROLLVELOCITYLOOP21PARAMETER ADJUSTSync KeyPitchDownPitchUpResetKeyNoFunction diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/loop_control.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/loop_control.svg new file mode 100644 index 0000000000..276fa93bfa --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/loop_control.svg @@ -0,0 +1,2 @@ + +AUTOCUESSAMPLERSLICERCUE LOOPSSLICER LOOPROLLVELOCITYLOOP21PARAMETER ADJUSTLoop InLoop OutLoopActivateLoopToggleJumpBackJumpForwardLoop /2Loop x2NoFunction diff --git a/source/_static/controllers/numark_ns6ii_schematics/performancepads/sampler.svg b/source/_static/controllers/numark_ns6ii_schematics/performancepads/sampler.svg new file mode 100644 index 0000000000..d2fcb8a06e --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/performancepads/sampler.svg @@ -0,0 +1,2 @@ + +AUTOCUESLOOPSLICERCUE LOOPSSLICER LOOPROLLSAMPLERVELOCITY21PARAMETER ADJUSTSample 1Sample 2Sample 3Sample 4Sample 5Sample 6Sample 7Sample 8NoFunction diff --git a/source/_static/controllers/numark_ns6ii_schematics/top_view.svg b/source/_static/controllers/numark_ns6ii_schematics/top_view.svg new file mode 100644 index 0000000000..d05a78a00e --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/top_view.svg @@ -0,0 +1,3 @@ + +AUTOCUESLOOPSAMPLERSLICERCUE LOOPSSLICER LOOPROLLVELOCITYCUESYNCSCRATCHSLIPQUANTIZEUSBPC1 PC2BROWSE +FOCUSSHIFT21PARAMETER ADJUST+ %—%BLEEPKEYLOCKDECKPITCHKEYBPM%MINMAXSTRIP SEARCHLOADABMAXMINLOWMIDHIGHGAINLOHIFILTERCUEA OFF B2134PCLINEFX 1FX SELECTFX 2FX 3MODETAPMINMAXBOOTHVIEWSORT BY BPMMASTERBACKSORT BY SONGAREASORT BY KEYL.PREPSORT BY ARTISTBROWSETOUCH ALLTOUCH TAPTDECK34TOUCH FXTOUCH ROLLFX diff --git a/source/_static/controllers/numark_ns6ii_schematics/top_view_annotated.svg b/source/_static/controllers/numark_ns6ii_schematics/top_view_annotated.svg new file mode 100644 index 0000000000..b7fb9784e6 --- /dev/null +++ b/source/_static/controllers/numark_ns6ii_schematics/top_view_annotated.svg @@ -0,0 +1,3 @@ + +AUTOCUESLOOPSAMPLERSLICERCUE LOOPSSLICER LOOPROLLVELOCITYCUESYNCSCRATCHSLIPQUANTIZEUSBPC1 PC2BROWSE +FOCUSSHIFT21PARAMETER ADJUST+ %—%BLEEPKEYLOCKDECKPITCHKEYBPM%MINMAXSTRIP SEARCHLOADABMAXMINLOWMIDHIGHGAINLOHIFILTERCUEA OFF B2134PCLINEFX 1FX SELECTFX 2FX 3MODETAPMINMAXBOOTHVIEWSORT BY BPMMASTERBACKSORT BY SONGAREASORT BY KEYL.PREPSORT BY ARTISTBROWSETOUCH ALLTOUCH TAPTDECK34TOUCH FXTOUCH ROLLFX234026-3241392225352414333435363718221201917168615487-14, 38,46-4742-45 diff --git a/source/_static/controllers/reloop_mixage_overview.svg b/source/_static/controllers/reloop_mixage_overview.svg new file mode 100644 index 0000000000..afa942cf7d --- /dev/null +++ b/source/_static/controllers/reloop_mixage_overview.svg @@ -0,0 +1,8 @@ + + diff --git a/source/_static/controllers/reloop_mixage_top.jpg b/source/_static/controllers/reloop_mixage_top.jpg new file mode 100644 index 0000000000..f0a429de41 Binary files /dev/null and b/source/_static/controllers/reloop_mixage_top.jpg differ diff --git a/source/chapters/appendix/changelog.rst b/source/chapters/appendix/changelog.rst index cc9d3fc067..d32ecc3f03 100644 --- a/source/chapters/appendix/changelog.rst +++ b/source/chapters/appendix/changelog.rst @@ -52,6 +52,27 @@ Misc Refactorings * Refactor/shrink modernize scopedtimer `#13258 `__ +.. _v2-5-1: + +`2.5.1 `__ (unreleased) +------------------------------------------------------------------------- + +Controller Mappings +^^^^^^^^^^^^^^^^^^^ + + +* Numark NS6II: Add new controller mapping `#11075 `__ +* Hercules Inpulse 300: Updated mapping `#14051 `__ + +Fixes +^^^^^ + + +* Deere (64 samplers): Bring back library in regular view + `#14101 `__ + `#14097 `__ +* Enable R3 time-stretching with Rubberband 4.0.0 API version numbers `#14100 `__ + .. _v2-5-0: `2.5.0 `__ (2024-12-24) diff --git a/source/chapters/vinyl_control.rst b/source/chapters/vinyl_control.rst index 92053adef6..0817039e44 100644 --- a/source/chapters/vinyl_control.rst +++ b/source/chapters/vinyl_control.rst @@ -141,6 +141,8 @@ You can use any of the timecode media supported by Mixxx: +----------------------------------------+---------------------+ | MixVibes DVS V2 Vinyl | Very high | +----------------------------------------+---------------------+ +| Pioneer RekordBox DVS | Unknown | ++----------------------------------------+---------------------+ At the present time, Serato records are recommended if you are looking to buy vinyl. If you want to use CDs, you can download a free copy for personal use diff --git a/source/hardware/controllers/numark_ns6ii.rst b/source/hardware/controllers/numark_ns6ii.rst new file mode 100644 index 0000000000..1b031dfcb8 --- /dev/null +++ b/source/hardware/controllers/numark_ns6ii.rst @@ -0,0 +1,543 @@ +.. _numark-ns6ii: + +Numark NS6II +============ + +.. sectionauthor:: + Nikolaus Einhauser + + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/top_view.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: Numark NS6II (schematic view) + :figclass: pretty-figures + + Numark NS6II (schematic view) + + +The Numark NS6II is an all-in-one USB :term:`MIDI` controller with an integrated audio interface. +It has controls for 2 decks that can be toggled between decks to play with 4 decks. +Its jogwheels feature a built-in screen highlighting basic information on the currently +playing track of each deck. + +- `Manufacturer’s product page `__ +- `Serato DJ Hardware Page `__ +- `User Guide `__ + +.. versionadded:: 2.5.1 + +Mapping Description +------------------- + +You can download the latest Windows & MacOS drivers and firmware from the `manufacturer’s website `__. +Since the NS6II is a USB class compliant MIDI and audio device, the device is plug-and-play on Linux. + + +Audio Setup +----------- + +The mapping relies on the following channel assignments (for line/phono +input support, applying effects to the TR-S output, etc.): + +===================== ================ +Output Channels Assigned to +===================== ================ +1-2 Main +3-4 Headphones +===================== ================ + +===================== ================ +Input Channels Assigned to +===================== ================ +1-2 (CH 3 Line/Phono) Vinyl Control 1/3 +3-4 (CH 4 Line/Phono) Vinyl Control 2/4 +===================== ================ + +Only the Line/Phono inputs are sent back by the controller, no main nor headphone signal. + +The knobs for :hwlabel:`MASTER`, :hwlabel:`BOOTH`, :hwlabel:`CUE GAIN`, :hwlabel:`MIC LEVEL`, and :hwlabel:`CUE MIX` 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 main/booth/headphones/microphone channel levels to 100% (knob center position) +- Set cue/main mixing to cue-only (leftmost position) + + +Controller Layout +------------------ + +The control numbering in the schematic drawings matches the those found on the +specified page in the Owner's Manual. + + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/top_view_annotated.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: Numark NS6II (Annotated Topview) + :figclass: pretty-figures + + Numark NS6II (Annotated Topview) + +======== ====================================================================== ========================================== +No. Control Function +======== ====================================================================== ========================================== +1 LCD Display (:ref:`see below `) Show basic Metadata about currently playing deck +2 :hwlabel:`SHIFT` Button Activates alternative functionality on respective deck and all Mixer channels +3 :hwlabel:`Touch All` (On or Blinking) Touching an **FX Knob** enables it while it is touched and deactivated once released +3 :hwlabel:`Touch All` (Blinking) Touching an **EQ Knob** enables it while it is touched and deactivated once released +4 :hwlabel:`Deck 3`/:hwlabel:`Deck 4` Switch between controlling deck 1/3 or 2/4 +5 :hwlabel:`USB` See :ref:`numark-ns6ii-dj-changeover` +5 :hwlabel:`SHIFT` + :hwlabel:`USB` Switch deck to be controlled by PC1 (white) or PC2 (red) +6 :hwlabel:`LINE` / :hwlabel:`PC` Select Audio input Source for Mixer Channel 3/4 +15 Crossfader Fades volume between side A and B +16 :hwlabel:`Master` Gain Controls output volume of the hardware Master output +17 :hwlabel:`Booth` Gain Controls output volume of the hardware Booth output +18 Jog Wheel (top surface) Perform scratch operation (if scratch mode is enabled, otherwise perform as if outer edge was touched) +18 Jog Wheel (outer edge) Rotate to lower/raise playback speed (and pitch if key lock is off). +19 Play/Pause Button Starts/Stops/Resumes playback on the current Deck +20 :hwlabel:`CUE` Specifies, plays or recalls temporary cue point. Depends on :ref:`Cue mode ` +20 :hwlabel:`SHIFT` + :hwlabel:`CUE` Seeks to the Track start, then stops the Deck. +21 :hwlabel:`SYNC` button Short press to match tempo and phase of other deck once. Long press to enable :ref:`Sync Lock `. +21 :hwlabel:`SHIFT` + :hwlabel:`SYNC` button Press to toggle :term:`quantization`. +22 :hwlabel:`BLEEP` Button Press to play in reverse, return to where the track would be with no button press on button release. +22 :hwlabel:`SHIFT` + :hwlabel:`BLEEP` Button (:hwlabel:`KEYLOCK`) Toggle :term:`Keylock ` +23 :hwlabel:`SCRATCH` button Toggle platter scratching. If active, touching the jogwheel results in scratch behavior, if disabled jogwheel behaves as if only outer edge was touched. +23 :hwlabel:`SHIFT` + :hwlabel:`SCRATCH` button Switch display between showing remaining/elapsed time +24 :hwlabel:`STRIP SEARCH` Seek to absolute position in *stopped* track (does nothing for playing tracks to avoid accidents) +24 :hwlabel:`SHIFT` + :hwlabel:`STRIP SEARCH` Seek to absolute position in *playing* track +25 :hwlabel:`SLIP` toggle slip mode +25 :hwlabel:`SHIFT` + :hwlabel:`SLIP` (:hwlabel:`QUANTIZE`) Toggle Deck track repeat (quantize is mapped to :hwlabel:`SHIFT` + :hwlabel:`SYNC` instead) +33 :hwlabel:`BROWSE` encoder Navigate vertically in the library a single step at a time +33 :hwlabel:`SHIFT` + :hwlabel:`BROWSE` encoder Navigate vertically in the library jumping a configurable amount of steps each time +33 :hwlabel:`BROWSE` encoder press Perform :mixxx:coref:`GoToItem <[Library],GoToItem>` +34 :hwlabel:`VIEW` button Toggle maximized library view (useful when searching for tracks on small screens) +34 :hwlabel:`SHIFT` + :hwlabel:`VIEW` button Sort library by BPM +35 :hwlabel:`BACK` button Move Focus Back (jump between library sidebar and table) +35 :hwlabel:`SHIFT` + :hwlabel:`BACK` button Sort library by Song title +36 :hwlabel:`AREA` button Move Focus Forward (jump between library sidebar and table) +36 :hwlabel:`SHIFT` + :hwlabel:`AREA` button Sort library by Key +37 :hwlabel:`L.PREP` button Load track to :ref:`interface-preview-deck` +37 :hwlabel:`SHIFT` + :hwlabel:`L.PREP` button Sort library by Artist name +39 :hwlabel:`+%`/:hwlabel:`-%` Fader Move down to increase track tempo, move up to decrease. Behavior can be configured via :menuselection:`Preferences --> Decks --> Down increases Speed`. +40 takeover LEDs see :ref:`numark-ns6ii-takeover-leds`. +41 :hwlabel:`+` & :hwlabel:`-` buttons Temporarily speedup / slowdown the track (used for beatmatching). The exact behavior can be configured via :menuselection:`Preferences --> Decks --> Pitch bend behavior`. +48 :hwlabel:`TOUCH FX` Tristate (off/on/blinking). When on or blinking, merely touching an FX knob activate the FX while its touched and deactivated once released. If its blinking the same also applies to the EqKnobs. +======== ====================================================================== ========================================== + +.. _numark-ns6ii-takeover-leds: + +Takeover LEDs +^^^^^^^^^^^^^^ + +These indicate the physical position of the tempo fader relative to the software +one. The Tempo Fader uses soft-takeover, meaning if the physical location does +not match the software one, you will need to synchronize it manually again (this +avoids sudden jumps). The closer the slider is to its neutral position, the +brighter the middle LED is. The closer the physical slider position is to the +software position, the dimmer they get. This allows you to judge how far you +have to move the slider until you have synchronized the fader and how far you +have to move it until it is at neutral speed. These leds (with the exceptions of +the middle LED are also repeated on the Jogwheel LCD Display). + + +Mixer Section +^^^^^^^^^^^^^ + +The NS6II features 4 identical (with respect to symmetry) Mixer Channels. See :ref:`interface-eq-gain` for a complete explanation of the individual concepts + +.. image:: ../../_static/controllers/numark_ns6ii_schematics/mixer.svg + :align: left + :width: 20% + + +======== ============================================================== ========================================== +No. Control Function +======== ============================================================== ========================================== +38 :hwlabel:`LOAD` Load the currently selected track from the library into the deck corresponding to the channel +46 :hwlabel:`A` / :hwlabel:`B` Route Channel to left/right :ref:`Effect Unit `. +7 :hwlabel:`GAIN` Channel Gain (see :ref:`interface-eq-gain`) +9 :hwlabel:`HIGH` Channel High/Treble EQ +8 Channel VuMeter loudness of signal of that specific channel (after EQ, before Filter and Faders). A white LED indicates a clipping signal (see :term:`level meter`). +10 :hwlabel:`MID` Channel Mid EQ +11 :hwlabel:`LOW` Channel Low/Bass EQ +47 :hwlabel:`FILTER` This knob lets you control the Meta knob of the deck’s Quick Effect. +14 :hwlabel:`A OFF B` switch The :term:`crossfader` orientation switches determine to which side of the crossfader the deck is assigned. It can be set to the left or right side, or to the center where it is unaffected by the crossfader knob. +13 :hwlabel:`🎧` (pfl/cue) button Toggle :term:`PFL`. Notice: due to hardware constraints, this always works in numark mode: clicking a single button solos the corresponding channel, to listen to multiple channels, press and then release multiple buttons at once. +12 Channel Fader Decrease the volume of the channel +======== ============================================================== ========================================== + +Front Panel +^^^^^^^^^^^ + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/front_view.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (front view) + :figclass: pretty-figures + + Numark NS6II (front view) + +======== ============================================================== ========================================== +No. Control Function +======== ============================================================== ========================================== +1 :hwlabel:`🎧` 3.5mm (1/8") and 6.35mm (1/4") TRS Jacks/Sockets Sole audio output of the Headphone signal +2 :hwlabel:`GAIN` Knob Headphone signal gain (hardware) +3 :hwlabel:`SPLIT` Switch Switch between Stereo and SplitCue signal (see :ref:`interface-head-main`) (note: the v1.0.4 firmware :ref:`contains a bug `) +4 :hwlabel:`MIX` Knob Fade between Main and PFL signal +5 :hwlabel:`CF CONTOUR` Knob Change between a Crossfader curve suitable for scratching (hard cut) and smooth fading (constant power). +6 :hwlabel:`LEVEL` Knob Output Level of the microphone signal. Note that the microphone signal goes directly to the main output and is not sent to mixxx. +7 :hwlabel:`HIGH` Knob High EQ of the microphone signal +8 :hwlabel:`LOW` Knob Low EQ of the microphone signal +======== ============================================================== ========================================== + +Effects Section +^^^^^^^^^^^^^^^ + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/fx_unit.svg + :align: center + :width: 50% + :figwidth: 100% + :alt: NS6II (Effect Unit) + :figclass: pretty-figures + + Numark NS6II (Effect Unit) + +Left Section controls Effect Unit 1, right controls Effect Unit 2. For more details on Effect Units, see :ref:`effects`. +The mapping follows the standards :ref:`controller-effects-mapping`. + +.. _numark-ns6ii-jogwheel-display: + +Jogwheel Display +^^^^^^^^^^^^^^^^ + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/display.svg + :align: center + :width: 50% + :figwidth: 100% + :alt: NS6II (jogwheel display) + :figclass: pretty-figures + + Numark NS6II (jogwheel display) + +======== ========================================================================== +No. Function +======== ========================================================================== +1 Shows the deck currently being controlled by that side of the controller +2 The current position of the "virtual" vinyl sticker +3 Shows how far we are through the track (percentage) +4 Time Elapsed of / Remaining in the track. Elapsed/Remaining can be toggled with :hwlabel:`SHIFT` + :hwlabel:`SCRATCH` button +5 current BPM of the deck (with tempofader adjustments) +6 copy of the :ref:`numark-ns6ii-takeover-leds` +7 current Tempo Adjustment in percent +8 current Tempo Adjustment range in percent +9 Shows whether :term:`key lock` is enabled. +======== ========================================================================== + +Performance Pads +^^^^^^^^^^^^^^^^ + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/generic.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (performance pads) + :figclass: pretty-figures + + Numark NS6II (performance pads) + +Each controller Deck has a performance pad section controlling aspects of the deck or the currently playing track. + +The mode currently active mode can be selected by pressing the corresponding buttons. Each button cycles through a selection of modes which can be +seen in the table below. Pressing a mode button once results in a fully lit button, pressing it twice will blink on and off and pressing it three times results +in a repeating pattern consisting of three short blinks and a pause. The pattern indicates which mode is active. + +The functionality of the :hwlabel:`PARAMETER ADJUST` buttons (labelled 27) is specific to each mode. + +======== ==================== ======================= ================================ ================== +No. Label 1x Press 2x Press 3x Press +======== ==================== ======================= ================================ ================== +28 :hwlabel:`CUES` Hotcues 1-8 Hotcues 1-9 +29 :hwlabel:`AUTO` AutoLoop LoopRoll +30 :hwlabel:`LOOP` Loop Control KeyControl +31 :hwlabel:`SAMPLER` Samplers 1-8 Normal Samplers 1-8 Velocity-sensitive +32 :hwlabel:`SLICER` beat jumping intro/outro markers beatgridsettings +======== ==================== ======================= ================================ ================== + +Hotcues +""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/hotcues.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (performance pads) + :figclass: pretty-figures + + Numark NS6II (performance pads) + +======== ================================================================== ==================================================================================================================================================================================== +No. Control Function +======== ================================================================== ==================================================================================================================================================================================== +1-8 Pad (unlit) Save current position as hot cue (hotcue index as labelled). +1-8 Pad (lit) Jump to hot cue. If the track is stopped, holding the pad will preview the hot cue until the pad is released. +1-8 :hwlabel:`SHIFT` + Pad (lit) Clear hot cue. +27 :hwlabel:`PARAMETER ADJUST` no functionality +27 :hwlabel:`SHIFT` + :hwlabel:`PARAMETER ADJUST` Change the color of the currently focused (last pressed) hotcue. Cycles forwards/backwards through the colors of the currently selected palette (see :ref:`configuration-colors-editor`) +======== ================================================================== ==================================================================================================================================================================================== + +Pressing the hotcue selector a second time, the second hotcue mode will get selected, making it possible to access hotcues 9-16. + +.. _numark-ns6ii-autoloop: + +Auto Loop Mode +"""""""""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/auto_loop.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (autoloop) + :figclass: pretty-figures + + Numark NS6II (autoloop) + +======== ================================================================== ==================================================================================================================================================================================== +No. Control Function +======== ================================================================== ==================================================================================================================================================================================== +1-8 Pad (unlit) + loop disabled activate loop at current position for the specified length +1-8 Pad (unlit) + loop enabled change currently active loop length +1-8 Pad (lit) deactivate loop +27 :hwlabel:`PARAMETER ADJUST` double/half the size of each loop activated by a specific pad. +======== ================================================================== ==================================================================================================================================================================================== + +.. _numark-ns6ii-looproll: + +Loop Roll Mode +"""""""""""""" + +Works exactly like :ref:`numark-ns6ii-autoloop`, but the loop will get deactivated after letting go of the pad and the track resumes at the position where it would +have been if it had not looped. + +Loop Control Mode +""""""""""""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/loop_control.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (loop control) + :figclass: pretty-figures + + Numark NS6II (loop control) + +======== ================================================================== ================================================================================================================================================== +No. Control Function +======== ================================================================== ================================================================================================================================================== +1 Loop in :mixxx:coref:`loop_in <[ChannelN],loop_in>` +2 Loop Out :mixxx:coref:`loop_out <[ChannelN],loop_out>` +3 Loop Activate :mixxx:coref:`beatloop_activate <[ChannelN],beatloop_activate>` +4 Loop Toggle :mixxx:coref:`reloop_exit <[ChannelN],reloop_exit>`. Lit if loop is active. +5 Jump loop back :mixxx:coref:`beatjump_backward <[ChannelN],beatjump_backward>`. +6 Jump forward :mixxx:coref:`beatjump_forward <[ChannelN],beatjump_forward>`. +7 Loop /2 :mixxx:coref:`loop_halve <[ChannelN],loop_halve>`. +8 Loop x2 :mixxx:coref:`loop_double <[ChannelN],loop_double>`. +27 :hwlabel:`PARAMETER ADJUST` No function +======== ================================================================== ================================================================================================================================================== + + +Key Control +""""""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/key_control.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (key control) + :figclass: pretty-figures + + Numark NS6II (key control) + +======== ================================================================== ================================================================================================================================================== +No. Control Function +======== ================================================================== ================================================================================================================================================== +1 Sync Key :mixxx:coref:`sync_key <[ChannelN],sync_key>` +2 Pitch Down :mixxx:coref:`pitch_down <[ChannelN],pitch_down>` +3 Pitch Up :mixxx:coref:`pitch_up <[ChannelN],pitch_up>` +4 Reset Key :mixxx:coref:`reset_key <[ChannelN],reset_key>` +5 - 8 Pad Unused +27 :hwlabel:`PARAMETER ADJUST` No function +======== ================================================================== ================================================================================================================================================== + + +Sampler Pads +"""""""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/sampler.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (sampler pads) + :figclass: pretty-figures + + Numark NS6II (sampler pads) + + +The sampler modes allow you to load, play and stop samples in the first 8 sample slots. + +======== =============================================================== ========================================== +No. Control Function +======== =============================================================== ========================================== +1-8 Pad (unlit) Load currently selected track into the sample slot associated with the pad. +1-8 :hwlabel:`SHIFT` + Pad (lit) If the sample is playing, stop the playback. If the sample is not playing, eject the sample from the sample slot. +1-8 Pad (lit) Play the sample in the sample slot associated with the pad. *Velocity Sampler Mode*: The playback volume of the sample depends on the pressure (velocity). +27 :hwlabel:`PARAMETER ADJUST` No function +======== =============================================================== ========================================== + +.. _numark-ns6ii-beatjump: + +Beat Jump +"""""""""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/beat_jump.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (beat jump) + :figclass: pretty-figures + + Numark NS6II (beat jump) + + +The beat jump mode allows you to jump to specific beat positions in your loop. + +======== =============================================================== ========================================== +No. Control Function +======== =============================================================== ========================================== +1-4 Pad Jump forward to the beat position indicated by the pad. +5-8 Pad Jump backward to the beat position indicated by the pad. +27 :hwlabel:`PARAMETER ADJUST` Adjusts the loop size (halve/double each pad). +======== =============================================================== ========================================== + + +Intro/Outro Markers +""""""""""""""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/intro_outro.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (beat jump) + :figclass: pretty-figures + + Numark NS6II (beat jump) + +This mode allow you to prepare tracks by setting intro/outro cues. + +======== =============================================================== ========================================== +No. Control Function +======== =============================================================== ========================================== +1 Pad (unlit) Set current position as intro start. +1 Pad (lit) Jump to intro start position. +2 Pad (unlit) Set current position as intro end. +2 Pad (lit) Jump to intro end position. +3 Pad (unlit) Set current position as outro start. +3 Pad (lit) Jump to outro start position. +4 Pad (unlit) Set current position as outro end. +4 Pad (lit) Jump to outro end position. +5-8 Pad No function +27 :hwlabel:`PARAMETER ADJUST` No function +======== =============================================================== ========================================== + +Beatgrid Adjustments +"""""""""""""""""""" + +.. figure:: ../../_static/controllers/numark_ns6ii_schematics/performancepads/beatgrid_settings.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: NS6II (beatgrid) + :figclass: pretty-figures + + Numark NS6II (beatgrid) + +This mode allow you to adjust the beatgrid of a track. The layout mimics the Beatgrid controls of the Latenight skin. + +======== =============================================================== ========================================== +No. Control Function +======== =============================================================== ========================================== +1 Set Beatgrid at current position :mixxx:coref:`beats_translate_curpos <[ChannelN],beats_translate_curpos>` +2 Shift beatgrid earlier :mixxx:coref:`beats_translate_earlier <[ChannelN],beats_translate_earlier>` +3 Shift beatgrid later :mixxx:coref:`beats_translate_later <[ChannelN],beats_translate_later>` +4 Shift cues later :mixxx:coref:`shift_cues_later <[ChannelN],shift_cues_later>`. +5 BPM tap :mixxx:coref:`bpm_tap <[ChannelN],bpm_tap>`. This button does not exist in latenight. +6 beats adjust faster :mixxx:coref:`beats_adjust_faster <[ChannelN],beats_adjust_faster>`. +7 beats adjust slower :mixxx:coref:`beats_adjust_slower <[ChannelN],beats_adjust_slower>`. +8 shift cues earlier :mixxx:coref:`shift_cues_earlier <[ChannelN],shift_cues_earlier>`. +27 :hwlabel:`PARAMETER ADJUST` No function +======== =============================================================== ========================================== + +.. _numark-ns6ii-dj-changeover: + +DJ Changeover +------------- + +The NS6II allows two computers running Mixxx (likely also Serato DJ, but this is untested) to connect to the unit simultaneously. This allows +two DJs to play at the same time for easy DJ set changeovers. With a computer already connected +to the NS6II and playing (PC1), do the following: + +1. Connect a second computer (PC2) to the unused USB port on the NS6II's rear + panel. Once the computer has connected, the software will show all decks + offline. The first computer will still control both sides of the controller. + +2. Before giving PC2 control of one side of the NS6II, make sure no audio is playing + from PC2 on that deck. Then, press and hold the :hwlabel:`SHIFT` key and press the :hwlabel:`PC1/PC2` button on the non-playing deck. + + PC2 will now control the two channels on that side of the controller, and will + automatically have focus of the browse controls. Use the browse knob to + scroll through the library, then add the desired track to the deck by + pressing the Load button. + +3. Play a track on PC2's deck and mix it in when ready. For example, while PC1 is + using Deck A (and the mixer controls for Channels 1 & 3) to control their computer, + PC2 can also use Deck B (and the mixer controls for Channels 2 & 4) to control + their computer. + + With one computer controlling each deck, press the Browse Focus / PC1/PC2 button + on the non-playing deck to switch control of the browse knob. + +4. Fade out the audio playing from PC1's computer to the audio playing from PC2's + computer. When only the audio from PC2's computer is left in the mix, press and + hold the Shift key and press the Browse Focus / PC1/PC2 button on the + non-playing deck. Now, PC2 is using both Deck A and Deck B. + +5. Repeat steps 3 and 4 for the other side of the NS6II. + +Please note that you should always test the changeover process with a small +amount of music before performing it during a live set. + +.. _numark-ns6ii-split-cue-issue: + +.. note:: + + There is a bug in Firmware v1.0.4 (and possibly earlier) of the Numark NS6II + which causes the headsplit control to be sent inverted when the controller + status is sent. This happens on startup and when switching decks between + PC1/PC2. Numark is aware of the issue but they don't seem to be interested + in fixing it. Unfortunately it also doesn't happen 100% of the time, so if + you experience mono-sounding headphones you may need to explicitly sync + mixxx and the built-in mixer by toggling the split cue switch once. + +Settings +-------- + +================================================== =================================================== +Label Description +================================================== =================================================== +Use Button Backlight Checked: deactivated button has a slight (usually red) backlight, Unchecked: LED of deactivated button is completely off. +Move this many tracks at once with :hwlabel:SHIFT Amount of tracks moved in a single step when turning the :hwlabel:`BROWSE` encoder while pressing :hwlabel:`SHIFT`. +Loop size of the smallest Pad the size of the first pad on :ref:`numark-ns6ii-autoloop`, :ref:`numark-ns6ii-looproll` and :ref:`numark-ns6ii-beatjump`. +In controller script: ``NS6II.RATE_RANGES`` List of available :mixxx:coref:`rate ranges <[ChannelN],rateRange>` to cycle through using the Pitch Bend +/- Buttons. +================================================== =================================================== diff --git a/source/hardware/controllers/reloop_mixage.rst b/source/hardware/controllers/reloop_mixage.rst new file mode 100644 index 0000000000..b1f42edb9e --- /dev/null +++ b/source/hardware/controllers/reloop_mixage.rst @@ -0,0 +1,115 @@ +Reloop Mixage +============= + +The Reloop Mixage line of controllers contains 2-channel DJ controller. It offers two jog wheels, line faders, a cross-fader, controls for looping, effects, equalizers and gain controls. The Interface Edition version comes with an integrated soundcard, headphone connection and microphone input and exists in version MK1 (unmarked) and MK2 (marked on back of device). + +.. figure:: ../../_static/controllers/reloop_mixage_top.jpg + :align: center + :figwidth: 100% + :alt: Reloop Mixage IE (top view) + :figclass: pretty-figures + + Reloop Mixage top view (© Reloop, used with permission) + +Audio +----- + +This controller is a MIDI and audio class compliant device so it is compatible as-is with Linux, MacOS and Windows. On Windows, the manufacturer ships an :term:`ASIO` low-latency driver that can be found on the `manufacturer’s product +page `_. + +The microphone :hwlabel:`🎤` input can be set to different modes. To make it usable in Mixxx, set it to **SW**. The :hwlabel:`MASTER` and :hwlabel:`PHONES` level controls work directly on the audio hardware and can't be mapped in Mixxx. + +Control overview +---------------- + +.. figure:: ../../_static/controllers/reloop_mixage_overview.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: Reloop Mixage button overview + :figclass: pretty-figures + + Reloop Mixage button overview. + +All mapped controls use MIDI channel #1 (can be changed on the back of the device). Most functions on this controller are quite self-explanatory and mapped in that way (you might want to check the official manual too). + +====== ========================================= =========================================================================================================================================================================== ============================================================================================================================================================================== +# Label Function SHIFT function +====== ========================================= =========================================================================================================================================================================== ============================================================================================================================================================================== +1 :hwlabel:`-` Allows the temporary deceleration (counter-clockwise) of a track. Adjust track key down. +2 :hwlabel:`+` Allows the temporary acceleration (clockwise) of a track. Adjust track key up. +3 :hwlabel:`SHIFT` When this button is pressed all controls have a different function. The assignment can be viewed in the SHIFT function column. +4 :hwlabel:`LOOP` / :hwlabel:`IN` Set beatloop start at current play position and activate beatloop or turn it off if currently active. Set loop in point. +5 :hwlabel:`-LENGTH+` / :hwlabel:`BEATMOVE` Turn to halve/double loop length; Turn while pushing down to adjust beatjump size; Press shortly to clear any loop points. Turn to beatjump forward/backward. If a loop is active, move the loop forward/backward; Press shortly to enter/exit beatloop adjustment mode. +6 :hwlabel:`GAIN` Preamplication of a track/deck. Same as non-shift function. +7 Pitchfader Adjust the pitch or playback speed of the current deck. The LED lights up in the neutral position. Same as non-shift function. +8 :hwlabel:`RELOOP` / :hwlabel:`OUT` Toggle relooping on/off. Button is lit when a loop is active, blinks slowly if there's an inactive loop set and thus reloop is available. Set loop out point. +9 :hwlabel:`FX SEL` / :hwlabel:`MASTER` Select effect in effect unit N for adjustment. Button is lit if an effect slot is selected. Toggle if deck N is sync leader. +10 :hwlabel:`-DRY/WET+` / :hwlabel:`PAN` Turn to control dry/wet for effect rack N; Turn whilst pushing down to select effect preset for effect rack N; Press shortly to toggle effect(s) in the effect rack on/off. Select quick effect preset for deck N. Click to toggle quick effect on/off. +11 :hwlabel:`AMOUNT` / :hwlabel:`FILTER` Control effect meta knob when an effect slot is selected; Controls the effect rack meta knob when no effect slot is selected. Control quick effect super knob. +12 :hwlabel:`FX ON` / :hwlabel:`KEYLOCK` Toggle effect rack on/off for deck N. Toggle keylock (keep pitch on speed change) on/off. +13 :hwlabel:`🔍` Toggle to use jog wheel to scroll through deck. Same as non-shift function. +14 :hwlabel:`💿` Toggle to use jog wheel to scratch deck. Same as non-shift function. +15 Jog wheel Controls various functions depending on the jog wheel mode. Same as non-shift function. +16 :hwlabel:`⯈⯇` / :hwlabel:`CUE 1` Beat-sync deck as follower (hold to sync lock). If hot cue 1 is set, go to hot cue 1, else set hot cue 1 at current position. +17 :hwlabel:`CUP` / :hwlabel:`CUE 2` If at cue point, play when released. If not at cue point, sets a cue point. If hot cue 2 is set, go to hot cue 2, else set hot cue 2 at current position. +18 :hwlabel:`CUE` / :hwlabel:`CUE 3` If at cue point, plays until released. If not at cue point: If playing, goes to cue point and stops. If not playing, sets a cue point. If hot cue 3 is set, go to hot cue 3, else set hot cue 3 at current position. +19 :hwlabel:`⏯` / :hwlabel:`CUE 4` Play/pause deck. Hold the disc button :hwlabel:`💿` to soft start/brake the deck. If hot cue 4 is set, go to hot cue 4, else set hot cue 4 at current position. +20 :hwlabel:`TRAX` Turn to browse library. Press to play/pause track preview. Double-press to maximize/minimize library. Turn to browse side pane. +21 :hwlabel:`LOAD` / :hwlabel:`⯇` Load selected track from library into deck 1; LED lights up if deck is currently playing. Navigate left (close folder). +21 :hwlabel:`LOAD` / :hwlabel:`⯈` Load selected track from library into deck 2; LED lights up if deck is currently playing. Navigate right (open folder). +22 :hwlabel:`HIGH` Controls the high EQ. Same as non-shift function. +23 :hwlabel:`MID` Controls the mid EQ. Same as non-shift function. +24 :hwlabel:`LOW` Controls the low EQ. Same as non-shift function. +25 :hwlabel:`🎧` / :hwlabel:`PREV ⯈` Activate :term:`PFL ` for deck 1 Play preview deck. +25 :hwlabel:`🎧` / :hwlabel:`PREV ⏹` Activate :term:`PFL ` for deck 2 Stop preview deck. +26 Linefader Controls the respective channel's volume. Same as non-shift function. +33 Crossfader Crossfader between channel 1 and channel 2. Same as non-shift function. +====== ========================================= =========================================================================================================================================================================== ============================================================================================================================================================================== + +The effect buttons and knobs on the left side apply to effect unit 1, the ones on the right to effect unit 2. The numbers from the overview correspond to the product manual and mapping XML file Txx numbers. + +Jog wheel +--------- + +- With :hwlabel:`🔍` button active: Scroll through the track. While touching the top of the wheel scrolling is three times as fast. +- With :hwlabel:`💿` button active: Touch the side of the jog wheel to nudge the deck. Touch the top of the jog wheel to scratch (either deck playing or not). +- With the Beatloop adjust mode active: Adjusts the selected loop point. + +Beatloop adjust mode +-------------------- + +When a beatloop has been set, press :hwlabel:`SHIFT` + :hwlabel:`-LENGTH+` / :hwlabel:`BEATMOVE` to enable beatloop adjust mode. The :hwlabel:`LOOP` / :hwlabel:`IN` and :hwlabel:`RELOOP` / :hwlabel:`OUT` buttons will blink. Now you can: + +- Move the entire loop using the jog wheel, adjustment is three times as fast while the top of the jog wheel is touched. +- Press :hwlabel:`LOOP` / :hwlabel:`IN` to shift the loop in point using the jog wheel. The :hwlabel:`LOOP` / :hwlabel:`IN` will blink. +- Press :hwlabel:`RELOOP` / :hwlabel:`OUT` to shift the loop out point using the jog wheel. The :hwlabel:`RELOOP` / :hwlabel:`OUT` will blink. + +Hold :hwlabel:`SHIFT` and press :hwlabel:`-LENGTH+` / :hwlabel:`BEATMOVE`, or press :hwlabel:`🔍` or :hwlabel:`💿` button to leave beatloop adjust mode. + +User-adjustable script settings +------------------------------- + +The `Reloop-Mixage.scripts.js` controller script provides the following settings: + +- `scratchByWheelTouch` (default `false`): change to `true` to get a more regular, turntable-like mode, i.e. scratch by touching the jog wheel instead of having to toggle the disc button. Note that the jog wheels are not very sensitive to touch though (sensitivity can be adjusted on the back of the controller in the MK1 version). +- `scratchTicksPerRevolution` (default `620`): Change this to adjust the scratch speed. Smaller values mean "faster", higher mean "slower". +- `jogWheelScrollSpeed` (default `1.0`): Adjust this to change the jog wheel scroll speed. The higher the values, the faster. + +Controller diagnostic functions +------------------------------- + +Turn off the controller and hold one of these buttons while turning on the controller: + +- Right :hwlabel:`SHIFT` to display the firmware version on the four deck play/cue buttons. The number is display in little-endian binary, e.g 0101 meaning 5. +- Right :hwlabel:`⏯` to show jog wheel touch values. This can be used to adjust sensitivity on the MK1 version. +- Left :hwlabel:`⯈⯇` to light up all LEDs. Can be helpful when repairing the controller or replacing the LEDs. + +Links +----- + +- `Manufacturer's product page `_ +- `Forum thread `_ + +.. _productpage_url: https://www.reloop.com/reloop-mixage-ie +.. _forum_url: https://mixxx.discourse.group/t/reloop-mixage-mapping/14779