Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions source/chapters/appendix/mixxx_controls.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2442,7 +2442,7 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
[PreviewDeckN],scratch2
[SamplerN],scratch2

Affects absolute play speed & direction whether currently playing or not when :mixxx:coref:`[ChannelN],scratch2_enable` is active. (multiplicative). Use JavaScript ``engine.scratch`` functions to manipulate in controller mappings.
Affects absolute play speed & direction whether currently playing or not when :mixxx:coref:`[ChannelN],scratch2_enable` is active. (multiplicative). Use the JavaScript ``engine.scratchTick`` function to manipulate in controller mappings. See the `Scratching and jog wheels <https://github.com/mixxxdj/mixxx/wiki/midi%20scripting#user-content-scratching-and-jog-wheels>`__ section for more information.

:range: -3.0..3.0
:feedback: Waveform
Expand All @@ -2454,7 +2454,7 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
[PreviewDeckN],scratch2_enable
[SamplerN],scratch2_enable

Takes over play speed & direction for :mixxx:coref:`[ChannelN],scratch2`.
Takes over play speed & direction for :mixxx:coref:`[ChannelN],scratch2`. Use the JavaScript ``engine.scratchEnable``/``engine.scratchDisable`` functions to manipulate in controller mappings. See the `Scratching and jog wheels <https://github.com/mixxxdj/mixxx/wiki/midi%20scripting#user-content-scratching-and-jog-wheels>`__ section for more information.

:range: binary
:feedback: Waveform
Expand Down Expand Up @@ -4406,7 +4406,7 @@ In the meantime, skins and controller mappings that still use them will keep wor
:feedback: Waveform

.. deprecated:: ??
Use the JavaScript ``engine.scratch`` functions instead.
Use the JavaScript ``engine.scratchTick`` function to manipulate in controller mappings. See the `Scratching and jog wheels <https://github.com/mixxxdj/mixxx/wiki/midi%20scripting#user-content-scratching-and-jog-wheels>`__ section for more information.


.. mixxx:control:: [ChannelN],filter
Expand Down
50 changes: 50 additions & 0 deletions source/chapters/appendix/settings_directory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -79,3 +79,53 @@ Content

**soundconfig.xml**
Sound device configuration from Preferences > Sound Hardware

BackUp
------

**preferences**
To avoid users accidentally changing the BackUp settings, these settings
were not included in the preferences.
The BackUp settings need to be adjusted in the mixxx.cfg.

**default**
By default, Mixxx makes a BackUp once a day at startup.
By default, the last five BackUps are kept.

**settings**
[BackUp]
BackUpEnabled 1
BackUpFrequency daily
KeepXBUs 5
LastBackUp *

In the mixxx.cfg is a part [BackUp] containing the settings.
BackUpEnabled 1
The default '1' enables the backupsystem while 0 disables it.

BackUpFrequency daily
The default 'daily' sets the frequency to 1 BackUp a day,
'always' sets the frequency to 'a BackUp on every startup'

KeepXBUs 5
with the default setting of '5', five BackUps are kept, if you have already
5 BackUps the oldest will be deleted before Mixxx creates a new one.
You can change this value to change the number of kept BackUps.
Setting KeepXBUs to '0' will prevent Mixxx from deleting old BackUps,
in this case all BackUps will be kept.

The LastBackup field keeps the date (YYYYMMDD) of the last backup, used to determinate
the need of creating a new BackUp if the frequency is set to daily.

**location**
On Windows the BackUps are created in the folder in your Documents directory
-> <username>/Documents/Mixxx-BackUps
On MacOS the BackUps are created in the container of Mixxx
-> /Users/>username>/Library/Containers/org.mixxx.mixxx/Data/Documents/Mixxx-BackUps/
On Linux the BackUps are created in your home/Documents folder
-> /home//Documents/Mixxx-BackUps/

**BackUps on upgrade**
When Mixxx is upgraded to a new version a BackUp named 'Upgrade Version xxx'
will be created in a subfolder 'Upgrade' in the Mixxx-BackUps folder.
These backups will not be automatically deleted.
5 changes: 3 additions & 2 deletions source/chapters/getting_started.rst
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,9 @@ uninstall the old version.

Your settings and library will not be removed or reset, but they may be upgraded
when you launch the new version of Mixxx. Note that we do not guarantee that new
configurations will work on older versions of Mixxx, therefore you may want to
make a backup of your existing settings just in case.
configurations will work on older versions of Mixxx, Mixxx creates by default
one backup of your settings and library every day but maybe you may want to make
an extra backup of your existing settings just in case.

For locations in each supported :term:`OS <operating system>` as well as detailed descriptions of the settings files, go to :ref:`appendix-settings-files`.

Expand Down
Loading