Skip to content

Commit c4a9c1b

Browse files
committed
document keyboard mapping auto-reload
1 parent 79bf992 commit c4a9c1b

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

source/chapters/advanced_topics.rst

+7-4
Original file line numberDiff line numberDiff line change
@@ -136,10 +136,13 @@ Instead, copy the default mapping file to the following location:
136136
* macOS: :file:`~/Library/Containers/org.mixxx.mixxx/Data/Library/Application Support/Mixxx/Custom.kbd.cfg`
137137
* Windows: :file:`%LOCALAPPDATA%\\Mixxx\\Custom.kbd.cfg`
138138

139-
Then edit this file and save the changes. On the next startup, Mixxx will check
140-
if :file:`Custom.kbd.cfg` is present and load that file instead of the default
141-
mapping file. This has the advantage that you can always revert back to the
142-
default mapping by deleting :file:`Custom.kbd.cfg`.
139+
Then edit this file and save the changes. When keyboard shortcuts are toggled on by enabling
140+
:menuselection:`Options --> Keyboard Shortcuts`, Mixxx checks if :file:`Custom.kbd.cfg`
141+
is present and loads that file instead of the default mapping file. This has the advantage
142+
that you can always revert back to the default mapping by deleting :file:`Custom.kbd.cfg`.
143+
144+
Mixxx also watches the loaded keyboard mapping file and will automatically update shortcuts
145+
and tooltips when that file is changed.
143146

144147
For a list of controls that can be used in a keyboard mapping, see
145148
:ref:`appendix-mixxxcontrols`.

0 commit comments

Comments
 (0)