diff --git a/source/_static/Mixxx-200-Library-Add-to-Auto-DJ.png b/source/_static/Mixxx-200-Library-Add-to-Auto-DJ.png deleted file mode 100644 index f0a8598ae0..0000000000 Binary files a/source/_static/Mixxx-200-Library-Add-to-Auto-DJ.png and /dev/null differ diff --git a/source/_static/Mixxx-241-Library-Add-to-Auto-DJ.png b/source/_static/Mixxx-241-Library-Add-to-Auto-DJ.png new file mode 100644 index 0000000000..ffe38ce706 Binary files /dev/null and b/source/_static/Mixxx-241-Library-Add-to-Auto-DJ.png differ diff --git a/source/_static/Mixxx-241-Library-Auto-DJ.png b/source/_static/Mixxx-241-Library-Auto-DJ.png new file mode 100644 index 0000000000..bb0c40d581 Binary files /dev/null and b/source/_static/Mixxx-241-Library-Auto-DJ.png differ diff --git a/source/chapters/appendix/mixxx_controls.rst b/source/chapters/appendix/mixxx_controls.rst index 2af1fc3d8c..b260c60532 100644 --- a/source/chapters/appendix/mixxx_controls.rst +++ b/source/chapters/appendix/mixxx_controls.rst @@ -832,6 +832,45 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp .. versionadded:: 2.0.0 +.. mixxx:control:: [ChannelN],shift_cues_earlier + [PreviewDeckN],shift_cues_earlier + [SamplerN],shift_cues_earlier + + :range: binary + :feedback: All :term:`cue markers ` move left by 10ms. + + .. versionadded:: 2.3.0 + + +.. mixxx:control:: [ChannelN],shift_cues_later + [PreviewDeckN],shift_cues_later + [SamplerN],shift_cues_later + + :range: binary + :feedback: All :term:`cue markers ` move right by 10ms. + + .. versionadded:: 2.3.0 + + +.. mixxx:control:: [ChannelN],shift_cues_earlier_small + [PreviewDeckN],shift_cues_earlier_small + [SamplerN],shift_cues_earlier_small + + :range: binary + :feedback: All :term:`cue markers ` move left by 1ms. + + .. versionadded:: 2.3.0 + + +.. mixxx:control:: [ChannelN],shift_cues_later_small + [PreviewDeckN],shift_cues_later_small + [SamplerN],shift_cues_later_small + + :range: binary + :feedback: All :term:`cue markers ` move right by 1ms. + + .. versionadded:: 2.3.0 + .. mixxx:control:: [ChannelN],beats_undo_adjustment [PreviewDeckN],beats_undo_adjustment [SamplerN],beats_undo_adjustment diff --git a/source/chapters/djing_with_mixxx.rst b/source/chapters/djing_with_mixxx.rst index ba5dee3f35..21a0e9d4d2 100644 --- a/source/chapters/djing_with_mixxx.rst +++ b/source/chapters/djing_with_mixxx.rst @@ -392,7 +392,7 @@ Auto DJ .. sectionauthor:: S.Brandt -.. figure:: ../_static/Mixxx-111-Library-Auto-DJ.png +.. figure:: ../_static/Mixxx-241-Library-Auto-DJ.png :align: center :width: 100% :figwidth: 100% @@ -401,19 +401,31 @@ Auto DJ Mixxx library - Auto DJ view -Auto DJ allows you to automatically load tracks from the Auto DJ playlist when -the current track is nearly finished, and crossfade into it. See -:ref:`library-auto-dj`. +Auto DJ automatically loads tracks in the decks and mixes them. +Tracks can be manually added to the Auto DJ playlist, or automatically from assigned source crates or from the entire library. Auto DJ does not take into account the volume of each track, nor the frequency content, nor the rhythms, so it's not intended to be a replacement for a human DJ. However, it is good enough to give a human DJ a break without a major disruption to the mix. +For mixing, Auto DJ takes control of the :ref:`crossfader `. +Auto DJ requires at least one deck to be assigned to the left and right side of the crossfader. This can be done with the deck orientation switches next to the crossfader. If a deck's orientation is centered, the crossfader can't affect it. Note that in the official Tango skin, these switches are in the decks' transport controls row, and in Shade skin they don't exist because decks are statically assigned to the left and right side (bus). + +When Auto DJ is toggled on, it will use the first two opposing decks it finds. With default settings these would be decks 1 and 2, but depending on how the orientation switches are set, this could be any configuration, for example deck 4 on the left and deck 1 on the right. If no opposing decks are found Auto DJ won't start. + +.. note:: Note that Auto DJ is currently not aware which decks are currently visible, + i.e. it might pick currently hidden decks 3 and/or 4. Refer to the + :ref:`skin settings ` for how to toggle 4 decks. + +When you toggle Auto DJ off, the crossfader will stay on its last position. + +Each official Mixxx skin has an Auto DJ indicator icon, located either in the top toolbar or in the mixer. In some skins the crossfader is highlighted, too. + Loading tracks into Auto DJ --------------------------- To play tracks automatically, they must first be loaded into the Auto DJ playlist. The Auto DJ playlist is empty by default. -.. figure:: ../_static/Mixxx-200-Library-Add-to-Auto-DJ.png +.. figure:: ../_static/Mixxx-241-Library-Add-to-Auto-DJ.png :align: center :width: 50% :figwidth: 100% diff --git a/source/chapters/library.rst b/source/chapters/library.rst index ffd37b3604..9b3e52e7ed 100644 --- a/source/chapters/library.rst +++ b/source/chapters/library.rst @@ -375,8 +375,7 @@ a crate, or even the whole library) for tracks that match your search query. * Type your search term(s). Mixxx filters the tracks as you type and shows only those matching the search term(s). Search terms can include an artist's name, a song title, BPM, etc. -* To clear the search string hit :kbd:`ESC` or click the clear button right next - to the input field. +* To clear the search string click the clear button right next to the input field. * Hit :kbd:`TAB` to cycle between the search and the list of results in the library. Use the :kbd:`↑` and :kbd:`↓` keys to scroll in the list of results. @@ -699,24 +698,26 @@ mixing or for using Mixxx as media player. The Auto DJ features in detail: -* **Shuffle button**: Randomizes the order of tracks in the Auto DJ playlist. -* **Add Random button**: Adds a random track from track sources (crates) to the +* **Enable** toggle: Toggles the Auto DJ mode on or off. +* **Fade now** button: Triggers the transition to the next track. +* **Skip track** button: Skips the next track in the Auto DJ playlist. +* **Transition mode** selector: Choose a transition mode. +* **Transition time** spin-box: Determines the duration of the transition. A + negative value will add a pause between tracks. +* **Shuffle** button: Randomizes the order of tracks in the Auto DJ playlist. +* **Add Random track** button: Adds a random track from track sources (crates) to the Auto DJ queue. If no track sources are configured, the track is added from the library instead. -* **Skip track button**: Skips the next track in the Auto DJ playlist. -* **Fade now button**: Triggers the transition to the next track. -* **Transition time spin-box**: Determines the duration of the transition. A - negative value will add a pause between tracks. -* **Selection Info label**: Displays the duration and number of selected tracks. +* **Repeat the playlist** toggle: Re-queue played tracks. +* **Selection Info** label: Displays the duration and number of selected tracks. Press :kbd:`Ctrl` + :kbd:`A` to get the total duration of the AutoDJ queue. -* **Enable Auto DJ button**: Toggles the Auto DJ mode on or off. The :guilabel:`Skip track`, :guilabel:`Add Random` and :guilabel:`Fade now` buttons are only accessible if the Auto DJ mode is enabled. The Search field in -the upper left corner is disabled in Auto DJ. By default, Auto DJ removes tracks -after playing them but if you want it to play the same tracks over and over -again, you can activate the :guilabel:`Auto DJ Requeue` option in -:menuselection:`Preferences --> Auto DJ --> Re-queue tracks after playback`. +the upper left corner is disabled in Auto DJ. + +By default, Auto DJ removes tracks after playing them but if you want it to play the same +tracks over and over again, you can activate the :guilabel:`Repeat the playlist` toggle. .. _library-auto-dj-crates: diff --git a/source/chapters/livebroadcasting.rst b/source/chapters/livebroadcasting.rst index 196afb4406..e161ef1707 100644 --- a/source/chapters/livebroadcasting.rst +++ b/source/chapters/livebroadcasting.rst @@ -50,7 +50,7 @@ Streaming Servers server for stability and reliability reasons. Keep in mind that if want to stream audio to a significant number of listeners, you'll need enough bandwidth. Read the - `Shoutcast documentation `_ + `Shoutcast documentation `_ or `Icecast documentation `_ for server setup instructions. diff --git a/source/conf.py b/source/conf.py index 1d1080ba9c..f27098da12 100644 --- a/source/conf.py +++ b/source/conf.py @@ -444,6 +444,8 @@ # Ignore Twitter links because for some reason valid links sometimes fail # with "400 Bad Request" r"^https://twitter.com/\w+$", + # Ignore NI links entirely because they trip 403 in general. + r"^https://(?:www.)?native-instruments.com", # Ignore support links because we get 403 Client Errors (bad User Agent?) r"^https://support.native-instruments.com/", r"^https://support.serato.com/", @@ -456,6 +458,9 @@ "https://support.pioneerdj.com/hc/sections/*", "https://www.roland.com/global/products/dj-505/*", "https://web.archive.org/web/*", + "https://www.allen-heath.com/ahproducts/*", + "https://www.allen-heath.com/content/uploads/*", + "https://www.allen-heath.com/support/", ] # Avoid freezing during linkcheck diff --git a/source/glossary.rst b/source/glossary.rst index a134a6ea79..5f5a839073 100644 --- a/source/glossary.rst +++ b/source/glossary.rst @@ -386,6 +386,10 @@ Glossary of Terms track. DJs usually place hotcues at distinctive positions within a track such as drops, breaks or kicks and snares. Mixxx supports up to 36 hotcues. + cue marker + A catch-all term used in mixxx to refer to the :term:`cue point`, + :term:`hotcues ` and :ref:`intro and outro cues`. + bar In musical notation, a bar (or measure) is a segment of time defined by a given number of beats. Typically, a piece consists of several bars of the diff --git a/source/hardware/controllers/allen_heath_xone_k2_k1.rst b/source/hardware/controllers/allen_heath_xone_k2_k1.rst index 48c4013d29..9e9e27906e 100644 --- a/source/hardware/controllers/allen_heath_xone_k2_k1.rst +++ b/source/hardware/controllers/allen_heath_xone_k2_k1.rst @@ -10,10 +10,10 @@ 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 `__ +- `Manufacturer’s product page `__ - `Forum thread `__ - `Manufacturer’s User Guide `__ -- `Blank template diagrams `__ +- `Blank template diagrams `__ .. versionadded:: 1.11 diff --git a/source/hardware/controllers/hercules_djcontrol_air.rst b/source/hardware/controllers/hercules_djcontrol_air.rst index d29409102f..9e5c9e09fb 100644 --- a/source/hardware/controllers/hercules_djcontrol_air.rst +++ b/source/hardware/controllers/hercules_djcontrol_air.rst @@ -38,7 +38,7 @@ Mapping Description :alt: Hercules DJControl AIR (schematic view) :figclass: pretty-figures - Hercules DJControl AIR (schematic view). This picture is taken from the `Getting Started Tutorial `__ (courtesy of Guillemot Corporation S.A.). + Hercules DJControl AIR (schematic view). This picture is taken from the Getting Started Tutorial (courtesy of Guillemot Corporation S.A.). We assume from the annotated picture above that each decks have same controls. diff --git a/source/hardware/controllers/hercules_djcontrol_compact.rst b/source/hardware/controllers/hercules_djcontrol_compact.rst index dd0b924259..f0cd558929 100644 --- a/source/hardware/controllers/hercules_djcontrol_compact.rst +++ b/source/hardware/controllers/hercules_djcontrol_compact.rst @@ -2,7 +2,6 @@ Hercules DJControl Compact ========================== - `Manufacturer’s product page `__ -- `MIDI mapping manual `__ The Hercules DJControl Compact is a simple controller for basic two-channel mixing. This device does not have a built in sound card, so diff --git a/source/hardware/controllers/hercules_djcontrol_instinct.rst b/source/hardware/controllers/hercules_djcontrol_instinct.rst index 8a0595b220..4cd16e97f2 100644 --- a/source/hardware/controllers/hercules_djcontrol_instinct.rst +++ b/source/hardware/controllers/hercules_djcontrol_instinct.rst @@ -41,7 +41,7 @@ Controls :alt: Hercules DJControl Instinct (schematic view) :figclass: pretty-figures - Hercules DJControl Instinct (schematic view). This picture is taken from `product poster `__ (courtesy of Guillemot Corporation S.A.). + Hercules DJControl Instinct (schematic view). This picture is taken from the product poster in the device manual (courtesy of Guillemot Corporation S.A.). 1. Jog Wheel for the deck on the side of the wheel 2. Action buttons for the deck on the side of the controls, depending on diff --git a/source/hardware/controllers/korg_kaoss_dj.rst b/source/hardware/controllers/korg_kaoss_dj.rst index 106b8128ec..37ba436d96 100644 --- a/source/hardware/controllers/korg_kaoss_dj.rst +++ b/source/hardware/controllers/korg_kaoss_dj.rst @@ -7,6 +7,8 @@ Korg Kaoss DJ controller - `Forum thread `__ - `Pull request on Github `__ +macOS: Please note that the Korg Kaoss DJ is only supported until `macOS Monterey `__ + .. versionadded:: 2.1 Mapping