Editing keybindings

1. Right-click one of these GUI elements:
   • Buttons
   • Checkboxes
   • Radio-buttons
   • Popup-menu entries
   • Main menu entries
   After right-clicking one of these elements, select "Add keybinding", "Change keybinding", or "Remove keybinding". If you select "Add keybinding" or "Change keybinding", the program will ask you to press a key combination.

2. Add custom keybindings manually to the config file.
   • On Windows, create/edit this file: C:\Users\<Username>\.radium\keybindings.conf
   • On macOS, create/edit this file: /Users/<Username>/.radium/keybindings.conf
   • On Linux, create/edit this file: /home/<Username>/.radium/keybindings.conf

   After changing this file, either restart Radium or select "Reload keyboard configuration" from the Help menu.

Config file examples (this is all you need to know to get started)

1. Change "Left Ctrl + z" to open the "about window":
   

   Z CTRL_L : ra.openAboutWindow
   

   A keybinding normally starts with the name of a key (e.g. "Z"), followed by 0 or more qualifiers (e.g. "CTRL_L").
   

2. If a keybinding lacks a key, it will use the key from the last defined keybinding that had a key. Example:

   F12          : ra.showMixerHelpWindow
        CTRL_R  : ra.showKeybindingHelpWindow
        SHIFT_R : ra.showFXHelpWindow
   

3. For more examples, look at the default keybindings.conf file, and look at protos.conf for a complete list of available functions.

Qualifier names

The qualifiers are CTRL_L, CTRL_R, SHIFT_L, SHIFT_R, EXTRA_L, ALT_L, ALT_R, FOCUS_EDITOR, FOCUS_MIXER, FOCUS_SEQUENCER, MOUSE_EDITOR, MOUSE_MIXER, MOUSE_SEQUENCER, and UP.

Qualifiers are AND-ed together and not OR-ed. For instance, "A CTRL_L SHIFT_L" means that you have to press all the keys "a", "left ctrl", and "left shift" at the same time.

• FOCUS_EDITOR is true if the editor has keyboard focus, marked by a thin orange frame. (Same for FOCUS_MIXER, and FOCUS_SEQUENCER.)
  Note that the FOCUS_* qualifiers are OR-ed, not AND-ed.

• MOUSE_EDITOR is true if the mouse pointer is placed inside the editor. (Same for MOUSE_MIXER, and MOUSE_SEQUENCER.)
  Note that the MOUSE_* qualifiers are OR-ed, not AND-ed.

• UP is true when releasing the key instead of pressing it.

• ALT_L is mapped to the Left Alt key. On a Mac, this key is sometimes called the "Option" key.

• ALT_R is mapped to "Alt Gr" on a PC. On a Mac, this key is either marked "Alt" or "Option", and is placed on the right side of the space bar.

• EXTRA_L is mapped to the left "windows" key on a PC. On a Mac, the key is mapped to the left "command" or "cmd" key.

• EXTRA_R is mapped to the "menu" key on a PC. On a Mac, it is mapped to the right "command" key. On a PC (Linux/Windows), EXTRA_R is a normal key and can not be used as a qualifier. On a Mac, EXTRA_R is the same as pressing CTRL_R, since apple keyboards often lack a right ctrl key.

Key names

1. Alphanumeric keys: 0, ..., 9, and A, ..., Z.

2. Locale-independent alphanumeric keys (QWERTY): QWERTY_1, ...QWERTY_0, and QWERTY_A, ..., QWERTY_Z.
   

3. Name of common non-alphanumeric keys: SPACE, INSERT, HOME, PAGE_UP, DEL, END, PAGE_DOWN, DOWNARROW, UPARROW, RIGHTARROW, LEFTARROW, RETURN, TAB, BACKSPACE, ESC, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, F16, F20.

4. Keypad: KP_DIV, KP_MUL, KP_SUB, KP_ADD, KP_0, KP_DOT, KP_ENTER, KP_1, KP_2, KP_3, KP_4, KP_5, KP_6, KP_7, KP_8, KP_9,

5. Multimedia keys (not always available): VOLUME_DOWN, VOLUME_UP, MUTE, PLAY, STOP.

6. Special keys (not always available): CALCULATOR, MAIL, HOMEPAGE.

7. MENU key: Placed between SPACE and CTRL_R on a PC (the "Windows Menu" key). Not available on Mac.

8. xLx and xRx Keys (QWERTY):
   
   • 1L1: The key 1 step to Left of the key 1. (The key below the Esc)

   • OR1: The key 1 step to Right of the key 0 (zero). (I.e. between 0 and Backspace)
   • OR2: The key 2 steps to Right of the key 0 (zero). (I.e. between 0 and Backspace)
   • OR3: The key 3 steps to Right of the key 0 (zero). (I.e. between 0 and Backspace)

   • PR1: The key 1 step to Right of the key P.
   • PR2: The key 2 steps to Right of the key P.

   • LR1: The key 1 step to Right of the key L.
   • LR2: The key 2 steps to Right of the key L.
   • LR3: The key 3 steps to Right of the key L.

   • ZL1: The key 1 step to Left of the key Z.

   • MR1: The key 1 step to Right of the key M.
   • MR2: The key 2 steps to Right of the key M.
   • MR3: The key 3 steps to Right of the key M.

Bind Scheme code or Python code

If you want to run S7 Scheme code, or Python code, use the functions ra.evalScheme or ra.evalPython:


X CTRL_L : ra.evalPython "ra.openAboutWindow()"
C CTRL_L : ra.evalScheme "(ra:open-about-window)"

Note that any code between the asterisks are executed as Python code when Radium starts up. This makes it posssible to add custom functions and classes in a convenient way:


*
def hello(what):
  print "hello "+what
*

ESC: keybinding.hello "world"
    


"*" can also be used to bind Python code directly to a key:


ESC: *
  print "hello world"
*
    


To load custom Scheme code during startup, you can call ra.evalScheme inside the asterisks:


*
ra.evalScheme('(load "C:\Users\Username\.radium\mystuff.scm")')
*
    

#include macos_notes_include.html