Using

Scripting

Keyboard Shortcuts

Viewing or Modifying the keyboard shortcuts

XChat defines many (but not all) of its keyboard shortcuts via a GUI window which is available by navigating to Settings -> Advanced -> Keyboard Shortcuts....

XChat's default keyboard shortcuts with labels
XChat's default keyboard shortcuts
  1. Existing shortcuts list
  2. Add button
  3. Delete button
  4. Main Keyboard Key
  5. Field Data 1: a parameter used by many actions
  6. Field Data 2: a parameter used in a few actions
  7. Keyboard modifier selection
  8. Action type drop down
  9. Description of Action

Adding a new shortcut

In this example, we will create a keyboard shortcut similar to the default Ctrl+Page Down shortcut which goes to the next tab in your channel list. However, instead of moving only one tab away, this shortcut will be "super" and move three tabs away. Since this will be the "super" version, we will use the shortcut Ctrl+Alt+Page Down (Ctrl+Shift+Page Down is already used for modifying the tab order).

  1. Select the Add Button.
  2. Scroll to the bottom of the existing shortcuts list. New items are always added to the bottom, but they get moved after you leave the Keyboard Shortcuts window.
  3. Select the row that is filled with <none> <none> <none> <none>
  4. Change the action type dropdown to Change Page
    • Note that at this point, the Description of Action field will change to a description of the "Change Page" action
    • The default value for the action dropdown is Run Command, but this isn't the default value for the action itself. The action itself defaults to <none>, so if you wish the command to be Run Command, select the dropdown with either mouse or space bar, and then either click the row, hit enter, or the space bar.
  5. Tab to or use the cursor to select the main keyboard key field
  6. Press the Page Down button on your keyboard
  7. Using the mouse, select the Data 1 field. You must use the mouse to change fields, because if you press tab, the key field will be replaced with "Tab" and the cursor will be moved to the next field anyway
  8. From the action description, we see that Data 1 is which page to switch to, and if Data 2 is set to anything, the page we switch to is relative, so type 3 in the field and press Enter.
  9. Tab or cursor to the Data 2 field and set the value to relative and press Enter.
    The value of Data 2 could be anything, but "relative" makes it obvious what we intend the value to mean.
  10. Check the Ctrl and Alt keyboard modifier boxes

You can now close out of this window and test your newly created shortcut. The same process could be used with Page Up and -3 to go 3 tabs in the opposite direction.

Creating ctrl+u for underline

By default, XChat doesn't have a ctrl+u for underline, but using Keyboard Shortcuts, you can specify it yourself.

  1. Right click in the input area, select Insert Attribute or Character Code -> Underline
  2. ctrl+a to select everything in the input area. Even if you can't see something there, the underline is
  3. Open the Keyboard Shortcuts window and select Add New
  4. Scroll down to the end of the list and select the new item
  5. Change the drop down to Insert in Buffer
  6. Select the key field, and press "u"
  7. In the Data 1 field, ctrl+v to paste what is in the main input area and press Enter
  8. Check the Ctrl keyboard modifier box
  9. Close!

You could also use ctrl+shift+u+1f in order to create the underline character rather than using the right click method.

Modifying an existing shortcut

After you have found the shortcut you wish to modify, select it from the list and make the changes as explained in the New Shortcut section. If you modify either Data 1 or Data 2, remember to hit the Enter key after making your change.

Deleting an existing shortcut

Find the shortcut, select it, press the Delete button. So simple, it shouldn't even need its own section.

Default Keyboard Shortcuts in XChat which can be modified

Ctrl+PgUpChange Page Up/Left 1
Ctrl+PgDownChange Page Down/Right 1
Alt+1-9Change Page to the respective tab number (Alt+3 will send you to the 3rd tab in the XChat list)
Ctrl+OInsert the character for Original Text formating in the input box
Ctrl+BInsert the character for Bold Text formating in the input box (will unbold if a previous bold character is in the line)
Ctrl+KInsert the character for Color Text formating in the input box (will negate all color codes if not followed by a number, or a comma followed by a number)
Shift+PgUpScroll Up through the matches in nick auto complete
Shift+PgDownScroll Down through the matches in nick auto complete
PgUpScroll Up one screen in Text Area (as long as the nick list is not selected)
PgDownScroll Down one screen in Text Area (as long as the nick list is not selected)
Shift+UpScroll Up one line in Text Area (as long as the nick list is not selected)
Shift+DownScroll Down one line in Text Area (as long as the nick list is not selected)
UpChange inbut box to previously typed command/line (as long as the nick list is not selected)
DownChange inbut box to next typed command/line (as long as the nick list is not selected)
Space
Return
Enter
Check for Auto Replace?
Ctrl+TabSame as Tab (attempt to complete the nick/command in the input box)
Alt+LeftMove front tab Left (Tab view) or Up (Tree view)
Alt+RightMove front tab Right (Tab view) or Down (Tree view)
Ctrl+Shift+PgUpTab view: Move tab family Left
Tree view: Move tab family up if parent tab is selected
Tree view: Move tab up in list if not parent tab
Ctrl+Shift+PgDownTab view: Move tab family Right
Tree view: Move tab family down if parent tab is selected
Tree view: Move tab down in list if not parent tab
F9Toggle if the Menu bar should be shown or hidden

Default Keyboard Shortcuts in XChat which cannot be modified

Ctrl+SOpen network list
Ctrl+TCreate new server tab
Ctrl+IDetach or Re-attach tab
Ctrl+WClose tab
Ctrl+QQuit
Ctrl+F7
-or-
F7
Toggle User List view (which one is used depends on GTK settings)
Ctrl+F9
-or-
F9
Toggle menu bar (which one is used depends on GTK settings)
Alt+AMark as away/back
Ctrl+MReset marker line
Ctrl+LClear Text
Ctrl+FSearch Text
F1Open up XChat Documentation in browser


Print - Recent Changes - Search
Page last modified on April 05, 2010, at 02:41 AM