Keyboard Preferences

Peter 10Apr12 ToDo-1 Add note re the binding of hot-keys to effects, generators and analyzers once the functionality has stabilized. And add a link to the place(s) where it ends up getting documented, probably Keyboard Preferences, Generate Menu, Effect Menu and Analyze Menu.

This preferences window sets the keyboard shortcuts which can be used for numerous commands in Audacity as an alternative to using Menus, Toolbars or mouse gestures.

Click on any of the other Preferences sections in the above image to go directly to that Preferences page.

A full list of the commands with their default key bindings is also available at Keyboard Shortcut Reference.

To view, change, delete or add Key Bindings

Category:

Use this menu to view: all key bindings; those key bindings associated with a particular menu, or; those key bindings not associated with any menu item (the Command choice).

Command/Key Combination list

These headings list all the commands which can be attached to keyboard shortcuts, together with their currently allocated shortcut or "binding".
When "All" is selected from the Category menu the commands are listed in the following order:

• Commands associated with the various Menus, listed in the order in which the menus appear (left to right) in the menu bar
  (As noted above, you can look at the key bindings associated with a particular menu by choosing the menu name from the Category menu)
• Commands not associated with any menu:
  (You can see just this list of key bindings by choosing "Command" from the Category menu)
  • Cycle through Dock, Track View and Selection Bar
  • Tools Toolbar
  • Transport Toolbar and associated Play commands
  • Additional Delete keys
  • Seek during playback
  • Move and toggle track focus
  • Move cursor
  • Adjust selection regions
  • Track Control Panel and Track Drop-Down Menu commands for focused track
  • Snap To
  • Full Screen on/off
  • Adjust output gain
  • Adjust input gain and source
  • Adjust playback speed

If you are looking for a particular command in the list and know its exact name, you can jump to it on Windows or Linux by typing the first letter of its name until you reach it.

Gale 03Oct11: Seeking by letter isn't working on Mac, see http://bugzilla.audacityteam.org/show_bug.cgi?id=236

Input box, Set and Clear buttons

• To change or add a binding:

1. Click to select the item you want to change in the Command/Key Combination window. The current key combination for that command (if any) will now appear in the input box to left of the Set button.
2. Either click in the input box, or press TAB once to switch focus to it.
3. Choose your binding by either holding any modifier key (or combination of modifiers) then pressing any non-modifier key, or press any non-modifier key on its own. Valid modifiers are:
   • SHIFT
   • CTRL (CMND on a Mac)
   • ALT
   • ALTGR (Windows only; this selects and is a shortcut for a combined CTRL + ALT modifier. ALTGR can thus be used as an alternative to call any binding that includes CTRL + ALT.)

   As an example, SHIFT+6  or CTRL+SHIFT+P  are both valid bindings. Your chosen key or key combination will now replace the previous content of the input box. Note: you cannot set the main system shortcut for Escape (ESC on Windows or ALT + C on some Linux systems) as a binding.

4. Click Set to apply your desired change. If your chosen key binding is already allocated to a command, Audacity will inform you and let you enter another binding instead.

• Clear: To remove a binding: select the item as above, then press Clear.

Export, Import and Default settings

• Export... and Import...: You can export and import key bindings (for example to keep a safe copy of your custom settings, or to transfer them to Audacity on another machine). Export... exports your bindings as an XML file, and Import... imports the XML file back again. You can also edit the XML file in any text editor and re-import it, as an alternative to editing the key bindings in Preferences.

  Note that Audacity does not check for bindings which are allocated to more than one command when importing the file, so edit carefully. The only entries you can usefully edit are the actual key bindings themselves which are in the "key" string at the end of each command. For example, to set the key binding for "New" to SHIFT+N, the command in the XML file should read:
  <command name="New" label="New" key="Shift+N"/>
  Be sure not to delete the closing "/>" characters at the end of the command.

• Defaults: Clicking the Defaults button reverts all bindings to those when you first obtained Audacity. This button is handy if you decide you have not got your changes right and want to start over again.

OK

• OK: When you have completed your edits press the OK button to save the new settings to your preferences and exit the dialog.

Cancel

• Cancel: If you press Cancel button this aborts the editing and all bindings will remain as they were before you started to edit them and the dialog will be exited.