diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml index c04f081e84..4e52cd21c4 100644 --- a/.github/workflows/changelog.yml +++ b/.github/workflows/changelog.yml @@ -46,7 +46,7 @@ jobs: env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - name: Trigger Rebuild - uses: peter-evans/repository-dispatch@v2 + uses: peter-evans/repository-dispatch@v3 if: env.GIT_DIRTY != null && env.GIT_DIRTY != '0' && env.MIXXXBOT_TOKEN != null with: token: ${{ env.MIXXXBOT_TOKEN }} diff --git a/.github/workflows/pre-commit.yml b/.github/workflows/pre-commit.yml index b2fbac1588..d2e9296f99 100644 --- a/.github/workflows/pre-commit.yml +++ b/.github/workflows/pre-commit.yml @@ -10,7 +10,7 @@ jobs: steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 - - uses: pre-commit/action@v3.0.0 + - uses: pre-commit/action@v3.0.1 env: SKIP: rstcheck diff --git a/source/chapters/appendix/mixxx_controls.rst b/source/chapters/appendix/mixxx_controls.rst index 2cb409c619..dcfb8ea364 100644 --- a/source/chapters/appendix/mixxx_controls.rst +++ b/source/chapters/appendix/mixxx_controls.rst @@ -538,6 +538,7 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp Its value is set to the sample position of the closest beat of the active beat and is used for updating the beat LEDs. + :range: -1, 0.0, real-valued :feedback: None @@ -546,6 +547,7 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [SamplerN],beat_distance Outputs the relative position of the play marker in the section between the the previous and next beat marker. + :range: 0.0 - 1.0, real-valued :feedback: None @@ -554,9 +556,9 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatjump [SamplerN],beatjump - Jump forward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>` (positive) or backward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>` (negative). If a loop is active, the loop is moved by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>`. + Jump forward (positive) or backward (negative) by N beats. If a loop is active, the loop is moved by X beats. - :range: real number, -1, 0, 1 + :range: any real number within the range, see :mixxx:coref:`[ChannelN],beatloop_X_activate` :feedback: Player jumps forward or backward by X beats. .. versionadded:: 2.0.0 @@ -566,7 +568,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatjump_size [SamplerN],beatjump_size - Set the number of beats to jump with :mixxx:coref:`beatjump_forward <[ChannelN],beatjump_forward>`/:mixxx:coref:`beatjump_backward <[ChannelN],beatjump_backward>`. + Set the number of beats to jump with :mixxx:coref:`beatjump_forward <[ChannelN],beatjump_forward>` + /:mixxx:coref:`beatjump_backward <[ChannelN],beatjump_backward>`. :range: positive real number :feedback: Beatjump size spinbox @@ -602,7 +605,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatjump_forward [SamplerN],beatjump_forward - Jump forward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>`. If a loop is active, the loop is moved forward by X beats. + Jump forward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>`. + If a loop is active, the loop is moved forward by X beats. :range: binary :feedback: Player jumps forward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>`. @@ -614,7 +618,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatjump_backward [SamplerN],beatjump_backward - Jump backward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>`. If a loop is active, the loop is moved backward by X beats. + Jump backward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>`. + If a loop is active, the loop is moved backward by X beats. :range: binary :feedback: Player jumps backward by :mixxx:coref:`beatjump_size <[ChannelN],beatjump_size>`. @@ -626,7 +631,9 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatjump_X_forward [SamplerN],beatjump_X_forward - Jump forward by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64. If a loop is active, the loop is moved forward by X betas. + Jump forward by X beats. A control exists for + X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512. + If a loop is active, the loop is moved forward by X beats. :range: binary :feedback: Player jumps forward by X beats. @@ -638,7 +645,9 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatjump_X_backward [SamplerN],beatjump_X_backward - Jump backward by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64. If a loop is active, the loop is moved backward by X beats. + Jump backward by X beats. A control exists for + X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512. + If a loop is active, the loop is moved backward by X beats. :range: binary :feedback: Player jumps backward by X beats. @@ -662,7 +671,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatloop_X_activate [SamplerN],beatloop_X_activate - Activates a loop over X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 + Activates a loop over X beats. A control exists for + X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512 :range: binary :feedback: A loop is shown over X beats. @@ -674,8 +684,11 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatloop_size [SamplerN],beatloop_size - Set the length of the loop in beats that will get set with :mixxx:coref:`beatloop_activate <[ChannelN],beatloop_activate>` and :mixxx:coref:`beatlooproll_activate <[ChannelN],beatlooproll_activate>`. - Changing this will resize an existing loop if the length of the loop matches :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>`. + Set the length of the loop in beats that will get set with + :mixxx:coref:`beatloop_activate <[ChannelN],beatloop_activate>` and + :mixxx:coref:`beatlooproll_activate <[ChannelN],beatlooproll_activate>`. + Changing this will resize an existing loop if the length of the loop matches + :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>`. :range: positive real number :feedback: Beatloop size spinbox and possibly loop section on waveform @@ -687,7 +700,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatloop_X_toggle [SamplerN],beatloop_X_toggle - Toggles a loop over X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 + Toggles a loop over X beats. A control exists for + X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512 :range: binary :feedback: A loop is shown over X beats. @@ -711,7 +725,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatlooproll_activate [SamplerN],beatlooproll_activate - Activates a rolling loop over :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>` beats. Once disabled, playback will resume where the track would have been if it had not entered the loop. + Activates a rolling loop over :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>` beats. + Once disabled, playback will resume where the track would have been if it had not entered the loop. :range: binary :feedback: A loop overlay is shown over :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>` beats on waveform. @@ -723,7 +738,9 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],beatlooproll_X_activate [SamplerN],beatlooproll_X_activate - Activates a rolling loop over X beats. Once disabled, playback will resume where the track would have been if it had not entered the loop. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 + Activates a rolling loop over X beats. Once disabled, playback will resume where the + track would have been if it had not entered the loop. A control exists for + X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512 :range: binary :feedback: Beatloop X button in skin is lit. A loop overlay is shown over X beats on waveform. @@ -1749,7 +1766,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],loop_move_X_forward [SamplerN],loop_move_X_forward - Moves the loop in and out points forward by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 + Moves the loop in and out points forward by X beats. A control exists for + X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512 :range: binary :feedback: Loop moves forward by X beats. @@ -1765,7 +1783,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],loop_move_X_backward [SamplerN],loop_move_X_backward - Loop moves by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 + Loop moves by X beats. A control exists for + X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64, 128, 256, 512 If a saved loop is currently enabled, the modification is saved to the hotcue slot immediately. @@ -1781,7 +1800,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp [PreviewDeckN],loop_scale [SamplerN],loop_scale - Scale the loop length by the value scale is set to by moving the end marker. :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>` is not updated to reflect the change. + Scale the loop length by the value scale is set to by moving the end marker. + :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>` is not updated to reflect the change. If a saved loop is currently enabled, the modification is saved to the hotcue slot immediately.