<page xmlns="http://projectmallard.org/1.0/"
      xmlns:ui="http://projectmallard.org/ui/1.0/"
      type="topic" style="task" version="1.0 ui/1.0"
      id="keyboard-shortcuts-set">

  <info>
    <link type="guide" xref="keyboard"/>
    <link type="seealso" xref="shell-keyboard-shortcuts"/>

    <revision pkgversion="3.8.0" version="0.3" date="2013-03-23" status="review"/>
    <revision pkgversion="3.9.92" date="2013-10-11" status="candidate"/>
    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>

    <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>
    <credit type="editor">
      <name>Juanjo Marín</name>
      <email>juanj.marin@juntadeandalucia.es</email>
    </credit>
    <credit type="editor">
      <name>Shobha Tyagi</name>
      <email>tyagishobha@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>Open the <gui xref="shell-terminology">Activities</gui> overview and
      start typing <gui>Keyboard</gui>.</p>
    </item>
    <item>
      <p>Click on <gui>Keyboard</gui> to open the panel.</p>
    </item>
    <item>
      <p>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="false">
<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="false">
<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 xref="keyboard-key-super">Super</key>
  <key>Page Up</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move window one workspace down</p></td>
	<td><p><keyseq><key>Shift</key><key>Super</key><key>Page Down</key></keyseq>
  </p></td>
  </tr>
  <tr>
	<td><p>Switch applications</p></td>
	<td><p><keyseq><key>Super</key><key>Tab</key></keyseq></p></td>
  </tr>
  <tr>
  <td><p>Switch windows</p></td>
  <td><p>Disabled</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>Super</key><key>Page Up</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Move to workspace below</p></td>
	<td><p><keyseq><key>Super</key><key>Page Down</key></keyseq></p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="false">
<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>
  <tr>
  <td><p>Record a screencast</p></td>
  <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>R</key>
  </keyseq></p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="false">
<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="false">
<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>Super</key><key>L</key></keyseq></p></td>
  </tr>
  <tr>
  <td><p>Show the message tray</p></td>
  <td><p><keyseq><key>Super</key><key>M</key></keyseq></p></td>
  </tr>
  <tr>
  <td><p>Focus the active notification</p></td>
  <td><p><keyseq><key>Super</key><key>N</key></keyseq></p></td>
  </tr>
  <tr>
  <td><p>Show all applications</p></td>
  <td><p><keyseq><key>Super</key><key>A</key></keyseq></p></td>
  </tr>
  <tr>
  <td><p>Open the application menu</p></td>
  <td><p><keyseq><key>Super</key><key>F10</key></keyseq></p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="false">
<title>Typing</title>
  <tr>
  <td><p>Switch to next input source</p></td>
  <td><p><keyseq><key>Super</key><key>Space</key></keyseq></p></td>
  </tr>

  <tr>
  <td><p>Switch to previous input source</p></td>
  <td><p>Disabled</p></td>
  </tr>
  <tr>
  <td><p>Modifiers-only switch to next source</p></td>
  <td><p>Disabled</p></td>
  </tr>
  <tr>
  <td><p>Compose Key</p></td>
  <td><p>Disabled</p></td>
  </tr>
  <tr>
  <td><p>Alternative Characters Key</p></td>
  <td><p>Disabled</p></td>
  </tr>
</table>

<table rules="rows" frame="top bottom" ui:expanded="false">
<title>Universal Access</title>
  <tr>
	<td><p>Turn zoom on or off</p></td>
	<td><p><keyseq><key>Alt</key><key>Super</key><key>8</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Zoom in</p></td>
  <td><p><keyseq><key>Alt</key><key>Super</key><key>=</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Zoom out</p></td>
  <td><p><keyseq><key>Alt</key><key>Super</key><key>-</key></keyseq></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="false">
<title>Windows</title>
  <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><keyseq><key>Super</key><key>&#8593;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Restore window</p></td>
  <td><p><keyseq><key>Super</key><key>&#8595;</key></keyseq></p></td>
  </tr>
  <tr>
	<td><p>Toggle shaded state</p></td>
	<td><p>Disabled</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>Hide window</p></td>
  <td><p><keyseq><key>Super</key><key>H</key></keyseq></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>
  <tr>
  <td><p>View split on left</p></td>
  <td><p><keyseq><key>Super</key><key>&#8592;</key></keyseq></p></td>
  </tr>
  <tr>
  <td><p>View split on right</p></td>
  <td><p><keyseq><key>Super</key><key>&#8594;</key></keyseq></p></td>
  </tr>
</table>

</section>

<section id="changing-shorcuts">
  <title>Change keyboard shortcuts</title>
  <p>This section shows how to change keyboard shortcuts for an application.</p>

  <steps>
    <item>
	<p>Open the Terminal application.</p>
     </item>
    <item><p>Run the <cmd>gsettings set org.gnome.desktop.interface can-change-accels true</cmd> command.</p>
    </item>
       <item>
      <p>Start the application for which you want to change the keyboard shortcut.</p>
    </item>
  <item>
      <p>Find the menu item for which you want to change the keyboard shortcut.</p>
    </item>
<item>
      <p>Type the shortcut that you want on the keyboard.</p>
    </item>
  </steps>

<note style="note style">
  <p>Note that this setting is desktop-wide. You can disable it after
 you make changes by running the
 <cmd>gsettings set org.gnome.desktop.interface can-change-accels false</cmd>
 command. You can also use the <app>dconf-editor</app> utility to do this.</p>
</note>
</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
      <gui style="button">+</gui> button (or click the
      <gui style="button">+</gui> 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 cannot have 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>
