mixxxdj · JoergAtGithub · May 7, 2026 · Apr 9, 2026 · May 2, 2026 · May 6, 2026
diff --git a/source/chapters/appendix/changelog.rst b/source/chapters/appendix/changelog.rst
@@ -973,7 +973,7 @@ Vinyl Control
 * Fix handling of "vinylcontrol_enabled" causes a frozen vinyl spinny mouse control
   `#15168 <https://github.com/mixxxdj/mixxx/pull/15168>`__
   `#15165 <https://github.com/mixxxdj/mixxx/issues/15165>`__
-* Pitch filter improvements `#15230 <https15054://github.com/mixxxdj/mixxx/pull/15230>`__
+* Pitch filter improvements `#15230 <https://github.com/mixxxdj/mixxx/pull/15230>`__
 * Add a quadrature phase tracker
   `#15217 <https://github.com/mixxxdj/mixxx/pull/15217>`__
   `#15283 <https://github.com/mixxxdj/mixxx/pull/15283>`__

diff --git a/source/hardware/controllers/akai_lpd8.md b/source/hardware/controllers/akai_lpd8.md
@@ -0,0 +1,13 @@
+# Akai LPD8
+
+-  [Manufacturer’s product page](https://web.archive.org/web/20251116094127/https://www.akaipro.com/lpd8)
+-  [Forum thread](https://mixxx.discourse.group/t/akai-lpd8-mapping-4-decks-30-hotcues-loops-etc-v2/13064)
+
+:::{versionadded} 1.10.1
+:::
+
+:::{note}
+Unfortunately a detailed description of this controller mapping is still missing.
+If you own this controller, please consider
+[contributing one](https://github.com/mixxxdj/mixxx/wiki/Contributing-Mappings#user-content-documenting-the-mapping).
+:::
diff --git a/source/hardware/controllers/akai_lpd8.rst b/source/hardware/controllers/akai_lpd8.rst
diff --git a/source/hardware/controllers/akai_mpd24.md b/source/hardware/controllers/akai_mpd24.md
@@ -0,0 +1,12 @@
+# Akai MPD24
+
+-  [Manufacturer’s product page](https://web.archive.org/web/20251116203708/https://www.akaipro.com/mpd24)
+-  [Forum thread](https://mixxx.discourse.group/t/akai-mpd24-midi-setup/9020)
+
+:::{versionadded} 1.8
+:::
+:::{note}
+Unfortunately a detailed description of this controller mapping is still missing.
+If you own this controller, please consider
+[contributing one](https://github.com/mixxxdj/mixxx/wiki/Contributing-Mappings#user-content-documenting-the-mapping).
+:::
diff --git a/source/hardware/controllers/akai_mpd24.rst b/source/hardware/controllers/akai_mpd24.rst
diff --git a/...re/controllers/allen_heath_xone_k2_k1.rst → ...are/controllers/allen_heath_xone_k2_k1.md b/...re/controllers/allen_heath_xone_k2_k1.rst → ...are/controllers/allen_heath_xone_k2_k1.md
@@ -1,7 +1,7 @@
-.. _allen-heath-xone-k2:
+(allen-heath-xone-k2)=
+
+# Allen & Heath Xone:K2
 
-Allen & Heath Xone:K2
-=====================
 
 The Allen & Heath Xone:K2 is a flexible controller that is mapped to
 control Mixxx’s decks, effects, or both. It has an integrated 4 channel
@@ -10,24 +10,23 @@ Xone K1 is the same as the Xone K2 but without the built in audio
 interface and does not come with the EVA travel case that the K2 comes
 with.
 
--  `Manufacturer’s product page <https://www.allen-heath.com/ahproducts/xonek2/>`__
--  `Forum thread <https://mixxx.discourse.group/t/allen-heath-xone-k2/12506>`__
--  `Manufacturer’s User Guide <https://www.allen-heath.com/content/uploads/2023/06/XoneK2_UG_AP8509_3.pdf>`__
--  `Blank template diagrams <https://www.allen-heath.com/content/uploads/2023/06/XoneK2BlankOverlays.zip>`__
+-  [Manufacturer’s product page](https://www.allen-heath.com/ahproducts/xonek2/)
+-  [Forum thread](https://mixxx.discourse.group/t/allen-heath-xone-k2/12506)
+-  [Manufacturer’s User Guide](https://www.allen-heath.com/content/uploads/2023/06/XoneK2_UG_AP8509_3.pdf)
+-  [Blank template diagrams](https://www.allen-heath.com/content/uploads/2023/06/XoneK2BlankOverlays.zip)
 
-.. versionadded:: 1.11
+:::{versionadded} 1.11
+:::
+## Audio Setup
 
-Audio Setup
------------
 
 The Xone:K2 is setup in Mixxx > Preferences > Sound Hardware > Output
 
-========== ======= =============
-Output     Device  Channel
-========== ======= =============
-Main       XONE:K2 Channel 3 - 4
-Headphones XONE:K2 Channel 1 - 2
-========== ======= =============
+| Output     | Device  | Channel |
+| --- | --- | --- |
+| Main       | XONE:K2 | Channel 3 - 4 |
+| Headphones | XONE:K2 | Channel 1 - 2 |
+
 
 Note: This Channel setup is the opposite of what most DJ controllers
 with an integrated audio interface use. The design choice to not use
@@ -41,12 +40,12 @@ volume. Adjusting the volume of main and headphone outputs is done by
 adjusting the gain for those outputs in Mixxx using the controller
 mapping.
 
-Setup
------
+## Setup
+
 
 **Requirement**: The Xone K2 must have Latching Layers turned off, which
-is the default. Refer to the `Xone K2
-manual <https://www.allen-heath.com/content/uploads/2023/06/XoneK2_UG_AP8509_3.pdf>`__ page
+is the default. Refer to the [Xone K2
+manual](https://www.allen-heath.com/content/uploads/2023/06/XoneK2_UG_AP8509_3.pdf) page
 12 for details. The K1 does not have Latching Layers.
 
 This mapping can used with one or multiple Xone K2s/K1s. Multiple Xone
@@ -73,8 +72,8 @@ when selecting the channel:
 -  Channel 9 (I): four effect units ordered 3 1 2 4
 -  Channel 8 (H): four effect units ordered 1 2 3 4
 
-Global Controls
----------------
+## Global Controls
+
 
 These are available on any configuration with decks, but not the 4
 effect unit layout.
@@ -93,8 +92,8 @@ effect unit layout.
    -  press and hold: load selected track into a deck by pressing the play button of the deck
    -  shift: main gain
 
-Decks
------
+## Decks
+
 
 The bottom right button is the shift button. The bottom left button
 toggles the bottom button grid between a loop layer (amber) and a hotcue
@@ -171,10 +170,10 @@ the same time activates supershift mode.
       If loop is enabled, move the loop backward by the beatjump size.
    -  supershift: halve beatjump size
 
-Effects
--------
+## Effects
 
-The top part of the column uses the :ref:`Standard Effects
+
+The top part of the column uses the {ref}`Standard Effects
 Mapping <controller-effects-mapping>`.
 Pressing the top encoder acts
 as the effect focus button. When no effect is focused, the buttons are
@@ -195,11 +194,11 @@ headphones channels and light up amber.
 
 The bottom encoders are not mapped in the 4 effect unit layout.
 
-Effect unit focusing
-~~~~~~~~~~~~~~~~~~~~
+### Effect unit focusing
+
 
 In addition to focusing one effect in a unit at a time with the
-:ref:`Standard Effects Mapping <controller-effects-mapping>`, the Xone
+{ref}`Standard Effects Mapping <controller-effects-mapping>`, the Xone
 K2/K1 has another mode for focusing a whole effect unit. This allows for
 controlling the parameters of all 3 effects in the unit at a time. This
 mode is only available on the 4 effect unit layouts. To access it, press
@@ -220,17 +219,17 @@ again. The next time Layer is pressed, the effect unit that was focused
 before will be remembered (but it will not be remembered after
 restarting Mixxx).
 
-Troubleshooting
----------------
+## Troubleshooting
+
 
 If general functionality or supershift are not working, double check
 that Latch Layers is turned off and MIDI CH is selected. Refer to the
-`Xone K2
-manual <https://www.allen-heath.com/content/uploads/2023/06/XoneK2_UG_AP8509_3.pdf>`__ page
+[Xone K2
+manual](https://www.allen-heath.com/content/uploads/2023/06/XoneK2_UG_AP8509_3.pdf) page
 12 for details.
 
-Known Issues
-------------
+## Known Issues
+
 
 There are a few known issues with the Xone K2/K1 firmware:
 
@@ -242,5 +241,5 @@ There are a few known issues with the Xone K2/K1 firmware:
    disconnecting the hub from the computer, the controller will not send MIDI
    input until it is powered down (unplugged) and plugged back in.
 
-If you would like these issues to be fixed, please let `Allen & Heath
-Support <https://www.allen-heath.com/support/>`__ know.
+If you would like these issues to be fixed, please let [Allen & Heath
+Support](https://www.allen-heath.com/support/) know.
diff --git a/source/hardware/controllers/american_audio_radius_2000.md b/source/hardware/controllers/american_audio_radius_2000.md
@@ -0,0 +1,15 @@
+# American Audio Radius 2000
+
+A CD and USB media player that can control Mixxx over USB with MIDI. It
+can also play timecode from CDs or USB drives which can control Mixxx
+when they are connected by a sound card.
+
+-  [Manufacturer’s product page](https://www.americandj.eu/en/radius-2000.html)
+
+:::{versionadded} 1.10
+:::
+:::{note}
+Unfortunately a detailed description of this controller mapping is still missing.
+If you own this controller, please consider
+[contributing one](https://github.com/mixxxdj/mixxx/wiki/Contributing-Mappings#user-content-documenting-the-mapping).
+:::
diff --git a/source/hardware/controllers/american_audio_radius_2000.rst b/source/hardware/controllers/american_audio_radius_2000.rst
diff --git a/...dware/controllers/american_audio_vms4.rst → ...rdware/controllers/american_audio_vms4.md b/...dware/controllers/american_audio_vms4.rst → ...rdware/controllers/american_audio_vms4.md
@@ -1,34 +1,34 @@
-American Audio VMS4/4.1
-=======================
+# American Audio VMS4/4.1
+
 
 The original VMS4 has problems with sound quality. The microphone input
 impedance is off and the output volume is low. The VMS4.1 is the same
 controller, except that those hardware issues have been fixed. The
 Traktor edition has different labels on some buttons & knobs, but it’s
 otherwise the same hardware as the VMS4.1.
 
--  `VMS4 <http://www.adj.com/vms4>`__
--  `VMS4.1 <http://www.adj.com/vms4-1>`__
--  `VMS4.1 Traktor edition <http://www.adj.com/vms4-1-traktor>`__
-
-.. versionadded:: 1.9
+-  [VMS4](http://www.adj.com/vms4)
+-  [VMS4.1](http://www.adj.com/vms4-1)
+-  [VMS4.1 Traktor edition](http://www.adj.com/vms4-1-traktor)
 
-Setup
------
+:::{versionadded} 1.9
+:::
+## Setup
 
-.. note::
-   Mixxx expects the VMS4 to be set to “Post EQ” mode for best
-   sound quality. Do this by holding down the Headphone Cue button on
-   Midilog 4 while powering on the unit. You only need to do this once.
-   (Each time you do, it changes the mode back and forth.) Consult the
-   `user manual <https://web.archive.org/web/20220727170646/intranet.americandj.com/ItemRelatedFiles/8347/vms4.pdf>`__
-   for more information.
 
-   To check the status of this in Linux, at a
-   console, issue the command ``lsusb -v|grep 'iSerial\|iProduct'`` and
-   look at the serial number under the VMS4 device per the instructions in
-   the user manual. As of this writing, the leading digit should be **1**.
+:::{note}
+Mixxx expects the VMS4 to be set to “Post EQ” mode for best
+sound quality. Do this by holding down the Headphone Cue button on
+Midilog 4 while powering on the unit. You only need to do this once.
+(Each time you do, it changes the mode back and forth.) Consult the
+[user manual](https://web.archive.org/web/20220727170646/intranet.americandj.com/ItemRelatedFiles/8347/vms4.pdf)
+for more information.
 
+To check the status of this in Linux, at a
+console, issue the command ``lsusb -v|grep 'iSerial\|iProduct'`` and
+look at the serial number under the VMS4 device per the instructions in
+the user manual. As of this writing, the leading digit should be **1**.
+:::
 1.  Make sure the VMS4 is off
 2.  Slide the switch on the front of the VMS4 to “8 OUT”
 
@@ -74,13 +74,13 @@ Setup
        and button area.
 
 10. Click the Enable checkbox in the right pane
-11. Click the drop-down and choose the :guilabel:`American Audio VMS4` preset
+11. Click the drop-down and choose the {guilabel}`American Audio VMS4` preset
 12. Click OK and the controller should light up. (In 1.9.x, the
     controller will light up when you load a track to a deck.)
 13. Continue reading below to know how everything is mapped
 
-Direct deck output implications
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+### Direct deck output implications
+
 
 This setup uses direct deck outputs because mixing takes place in the
 VMS4 hardware. The down side to this is that you won’t be able to use
@@ -89,8 +89,8 @@ Samplers. Using these features with a hardware + MIDI mixer like the
 VMS4 is not really feasible unless you used a separate sound interface
 or controlled Mixxx’s internal mixer another way.
 
-Control
--------
+## Control
+
 
 This guide explains how the VMS4 is mapped by default in Mixxx.
 
@@ -104,14 +104,14 @@ Just open the ``midi/American-Audio-VMS4-scripts.js`` file in your
 favorite text editor (Wordpad works too) and you’ll see these variables
 right near the top. Edit & save, then restart Mixxx and enjoy.
 
-Deck controls
--------------
+## Deck controls
 
-.. note::
-   There are a number of different face plates in the wild so
-   these images and control descriptions may not exactly match yours. The
-   locations of the controls are the key things to pay attention to.
 
+:::{note}
+There are a number of different face plates in the wild so
+these images and control descriptions may not exactly match yours. The
+locations of the controls are the key things to pay attention to.
+:::
 *The controls are the same on both sides of the controller. The left
 side controls Deck 1 and the right side controls Deck 2.*
 
@@ -157,29 +157,27 @@ side controls Deck 1 and the right side controls Deck 2.*
    Hold Shift and press to set this deck as the leader for syncing with another
 -  **Pause** - Stops the deck playback
 
-Effects section
-~~~~~~~~~~~~~~~
+### Effects section
+
 
 The left side controls effect unit 1 and the right side controls effect
 unit 2.
 
 -  **Select knob**
-
-  -  Rotate to choose the effect chain preset
-  -  Press to toggle whether the effect unit is on or not
+   -  Rotate to choose the effect chain preset
+   -  Press to toggle whether the effect unit is on or not
 
 -  **Control knob**
-
-  -  Adjusts the wet/dry ratio
-  -  When Parameter is on, this becomes the Wonder Knob, adjusting all
+   -  Adjusts the wet/dry ratio
+   -  When Parameter is on, this becomes the Wonder Knob, adjusting all
      effect parameters at once
 
 -  **On/Off** - Toggles the effect for the deck matching the effect unit
    number
 -  **Parameter** - Toggles what the above Control knob adjusts
 
-Sample section
-~~~~~~~~~~~~~~
+### Sample section
+
 
 The left side of the controller controls Sampler 1, and the right,
 Sampler 2.
@@ -196,8 +194,8 @@ Sampler 2.
    Hold Shift and press to stop playing.
 -  **Rec** - *Currently does nothing*
 
-Mixer controls
---------------
+## Mixer controls
+
 
 The volume sliders don’t control the ones in Mixxx because direct Deck
 outputs are affected by Mixxx’s internal ones.