<page xmlns="http://projectmallard.org/1.0/"
      xmlns:ui="http://projectmallard.org/experimental/ui/"
      type="topic" style="task"
      id="keyboard-shortcuts-set">
  <info>
    <link type="guide" xref="keyboard"/>
    <link type="seealso" xref="shell-keyboard-shortcuts"/>

    <revision pkgversion="3.6.0" version="0.2" date="2012-11-03" status="review"/>

    <credit type="author">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
    </credit>
    <credit type="author">
       <name>Julita Inca</name>
       <email>yrazes@gmail.com</email>
    </credit>
    <desc>Define or change keyboard shortcuts in <gui>Keyboard</gui> settings.</desc>
  </info>

  <title>Set keyboard shortcuts</title>

  <comment>
    <cite date="2012-02-19" href="mailto:shaunm@gnome.org">Shaun McCance</cite>
    <p>Define shortcuts, using Shortcuts tab in Keyboard settings. Provide
    reference for what everything is (can group for conciseness). Explain
    custom shortcuts.</p>
    <p>Important: the window says "To edit a shortcut, click the row and hold
    down the new keys or press Backspace to clear." This is actually wrong.
    You have to click the row, then click again on the shortcut within the
    row. File bug against control-center about the faulty message (or better,
    about the confusing interaction), but make sure to explain correctly in
    the help regardless.</p>
  </comment>

<p>To change the key or keys to be pressed for a keyboard shortcut:</p>

  <steps>
    <item>
	<p>Click your name on the top bar and select <gui>System Settings
    </gui>.</p></item>
    <item><p>Open <gui>Keyboard</gui> and select the <gui>Shortcuts</gui> tab.</p>
    </item>
    <item>
      <p>Select a category in the left pane, and the row for the desired action
      on the right. The current shortcut definition will change to
      <gui>New accelerator...</gui></p>
    </item>
    <item>
      <p>Hold down the desired key combination, or press <key>Backspace</key> to
      clear.</p>
    </item>
  </steps>


<section id="defined">
<title>Pre-defined shortcuts</title>
  <p>There are a number of pre-configured shortcuts that can be changed,
  grouped into these categories:</p>

<table rules="rows" frame="top bottom" ui:expanded="no">
<title>Launchers</title>
  <tr>
	<td><p>Launch help browser</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Launch calculator</p></td>
	<td><p>Calculator</p></td>
  </tr>
  <tr>
	<td><p>Launch email client</p></td>
	<td><p>Mail</p></td>
  </tr>
  <tr>
	<td><p>Launch web browser</p></td>
	<td><p>WWW</p></td>
  </tr>
  <tr>
	<td><p>Home folder</p></td>
	<td><p>Explorer</p></td>
  </tr>
  <tr>
	<td><p>Search</p></td>
	<td><p>Search</p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="no">
<title>Navigation</title>
  <tr>
	<td><p>Move window to workspace 1</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Move window to workspace 2</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Move window to workspace 3</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Move window to workspace 4</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Move window one workspace to the left</p></td>
	<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>&#8592;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move window one workspace to the right</p></td>
	<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>&#8594;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move window one workspace up</p></td>
	<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>&#8593;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move window one workspace down</p></td>
	<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>&#8595;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Switch applications</p></td>
	<td><p><keyseq><key>Alt</key><key>Tab</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Switch windows of an application</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Switch system controls</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Tab</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Switch windows directly</p></td>
	<td><p><keyseq><key>Alt</key><key>Esc</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Switch windows of an app directly</p></td>
	<td><p><keyseq><key>Alt</key><key>F6</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Switch system controls directly</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Esc</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Hide all normal windows</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Switch to workspace 1</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Switch to workspace 2</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Switch to workspace 3</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Switch to workspace 4</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Move to workspace left</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>&#8592;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move to workspace right</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>&#8594;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move to workspace above</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>&#8593;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move to workspace below</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>&#8595;</key></keyseq></p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="no">
<title>Screenshots</title>
  <tr>
	<td><p>Take a screenshot</p></td>
	<td><p><key>Print</key></p></td>
  </tr>
  <tr>
	<td><p>Take a screenshot of a window</p></td>
	<td><p><keyseq><key>Alt</key><key>Print</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Take a screenshot of an area</p></td>
	<td><p><keyseq><key>Shift</key><key>Print</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Copy a screenshot to clipboard</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Print</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Copy a screenshot of a window to clipboard</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Print</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Copy a screenshot of an area to clipboard</p></td>
	<td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Print</key></keyseq></p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="no">
<title>Sound and Media</title>
  <tr>
	<td><p>Volume mute</p></td>
	<td><p>Audio mute</p></td>
  </tr>
  <tr>
	<td><p>Volume down</p></td>
	<td><p>Audio lower volume</p></td>
  </tr>
  <tr>
	<td><p>Volume up</p></td>
	<td><p>Audio raise volume</p></td>
  </tr>
  <tr>
	<td><p>Launch media player</p></td>
	<td><p>Audio media</p></td>
  </tr>
  <tr>
	<td><p>Play (or play/pause)</p></td>
	<td><p>Audio play</p></td>
  </tr>
  <tr>
	<td><p>Pause playback</p></td>
	<td><p>Audio pause</p></td>
  </tr>
  <tr>
	<td><p>Stop playback</p></td>
	<td><p>Audio stop</p></td>
  </tr>
  <tr>
	<td><p>Previous track</p></td>
	<td><p>Audio previous</p></td>
  </tr>
  <tr>
	<td><p>Next track</p></td>
	<td><p>Audio next</p></td>
  </tr>
  <tr>
	<td><p>Eject</p></td>
	<td><p>Eject</p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="no">
<title>System</title>
  <tr>
	<td><p>Show the run command prompt</p></td>
	<td><p><keyseq><key>Alt</key><key>F2</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Show the activities overview</p></td>
	<td><p><keyseq><key>Alt</key><key>F1</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Log out</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Delete</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Lock screen</p></td>
	<td><p><keyseq><key>Ctrl</key><key>Alt</key><key>L</key></keyseq></p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="no">
<title>Universal Access</title>
  <tr>
	<td><p>Turn zoom on or off</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Zoom in</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Zoom out</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Turn screen reader on or off</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Turn on-screen keyboard on or off</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Increase text size</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Decrease text size</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>High contrast on or off</p></td>
	<td><p>Disabled</p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="no">
<title>Windows</title>

  <tr>
	<td><p>View split on left</p></td>
	<td><p><keyseq><key><link xref="windows-key">Super key</link></key><key>&#8592;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>View split on right</p></td>
	<td><p><keyseq><key><link xref="windows-key">Super key</link></key><key>&#8594;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Activate the window menu</p></td>
	<td><p><keyseq><key>Alt</key><key>Space</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Toggle fullscreen mode</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Toggle maximization state</p></td>
	<td><p><keyseq><key>Alt</key><key>F10</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Maximize window</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Restore window</p></td>
	<td><p><keyseq><key>Alt</key><key>F5</key></keyseq></p></td>
  </tr>

  <tr>
	<td><p>Toggle shaded state</p></td>
	<td><p><keyseq><key>Disabled</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Close window</p></td>
	<td><p><keyseq><key>Alt</key><key>F4</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Minimize window</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Move window</p></td>
	<td><p><keyseq><key>Alt</key><key>F7</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Resize window</p></td>
	<td><p><keyseq><key>Alt</key><key>F8</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Toggle window on all workspaces or one</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Raise window if covered, otherwise lower it</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Raise window above other windows</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Lower window below other windows</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Maximize window vertically</p></td>
	<td><p>Disabled</p></td>
  </tr>
  <tr>
	<td><p>Maximize window horizontally</p></td>
	<td><p>Disabled</p></td>
  </tr>
</table>

</section>

<section id="custom">
<title>Custom shortcuts</title>

<p>To create your own keyboard shortcut:</p>

  <steps>
    <item>
      <p>Select <gui>Custom Shortcuts</gui> in the left pane, and click the
      <key>+</key> button (or click the <key>+</key> button in any category).
      The <gui>Custom Shortcut</gui> window will appear.</p>
    </item>
    <item>
      <p>Type a <gui>Name</gui> to identify the shortcut, and a
      <gui>Command</gui> to run an application, then click <gui>Apply</gui>.
      For example, if you wanted the shortcut to open Rhythmbox, you could name
      it <input>Music</input> and use the <input>rhythmbox</input> command.</p>
    </item>
    <item>
      <p>Click <gui>Disabled</gui> in the row that was just added. When it
      changes to <gui>New accelerator...</gui>, hold down the desired shortcut
      key combination.</p>
    </item>
  </steps>
 <p>The command name that you type should be a valid system command. You
 can check that the command works by opening a Terminal and typing it in
 there. The command that opens an application may not have exactly the
 same name as the application itself.</p>

 <p>If you want to change the command that is associated with a custom keyboard
 shortcut, double-click the <em>name</em> of the shortcut. The
 <gui>Custom Shortcut</gui> window will appear, and you can edit the command.</p>
</section>

</page>
