# &applet; Applet Manual V&manrevision;

2002
2003
2004
Sun Microsystems
2000
2002
Emese Kovacs
2000
Szabolcs (Shooby) BAN
2000
Dan Mueth
GNOME Documentation Project

&legal;

Sun
GNOME Documentation Team
Sun Microsystems

Emese
Kovacs
GNOME Documentation Project

     emese@gnome.hu

Szabolcs (Shooby)
BAN
GNOME Documentation Project

     shooby@gnome.hu

Dan
Mueth
GNOME Documentation Project

     d-mueth@uchicago.edu

&applet; Applet Manual V&manrevision;
&date;

Sun GNOME Documentation Team

GNOME Documentation Project

Keyboard Layout Switcher Applet Manual V2.4
September 2003

Sun GNOME Documentation Team

GNOME Documentation Project

Keyboard Layout Switcher Applet Manual V2.3
August 2003

Sun GNOME Documentation Team

GNOME Documentation Project

Keyboard Layout Switcher Applet Manual V2.2
January 2003

Sun GNOME Documentation Team

GNOME Documentation Project

Keyboard Layout Switcher Applet Manual V2.1
August 2002

Sun GNOME Documentation Team

GNOME Documentation Project

Keyboard Layout Switcher Applet Manual V2.0
May 2002

Sun GNOME Documentation Team

GNOME Documentation Project

GNOME Keyboard Applet
January 2002

Emese Kovacs emese@gnome.hu

GNOME Documentation Project

GNOME Keyboard Applet
2000

Szabolcs (Shooby) BAN shooby@gnome.hu

Dan Mueth d-mueth@uchicago.edu

Emese Kovacs emese@gnome.hu

GNOME Documentation Project

This manual describes version &appletversion; of &applet;.

## Feedback

To report a bug or make a suggestion regarding the &applet; applet or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

### &applet; Applet

Shows &applet; applet. Contains flag and label of current keyboard layout.

The &applet; applet enables you to assign different layouts to your keyboard to suit different locales. The applet displays the flag and label associated with the current keyboard layout.

To add &applet; to a panel, right-click on the panel, then choose Add to Panel Utility Keyboard Indicator.

If you have an old version of XFree, Add to Panel Utility Keyboard Indicator adds the &applet; applet to the panel, as documented in this manual.

If you have a new version of XFree, Add to Panel Utility Keyboard Indicator adds a different keyboard layout applet, called gswitchit, to the panel. The gswitchit applet is documented in a separate manual.

## Usage

To switch to a different keyboard layout, click repeatedly on the applet until the applet displays the keyboard layout that you want. If the applet does not contain the keyboard layout that you require, see for information about how to add keyboard layouts to the applet.

## Preferences

To configure &applet;, right-click on the applet, then choose Preferences.

### Keyboards

The Keyboards tabbed section lists the keyboard layouts that are currently configured for the applet.

#### To Modify the List of Keyboard Layouts

To add a keyboard layout to the Keyboards list, perform the following steps:

1. Click Add. The applet displays the Select Keyboard dialog.

2. Click on the arrow next to the country for which you want to add a keyboard layout, then select the keyboard layout that you want to add.

3. Click Add to add the keyboard layout to the Keyboards list.

4. Click Close to close the Select Keyboard dialog.

To delete a keyboard layout from the Keyboards list, select the keyboard layout, then click Delete.

To move a keyboard layout up the Keyboards list, select the keyboard layout, then click Up. To move a keyboard layout down the Keyboards list, select the keyboard layout, then click Down.

#### To Edit a Keyboard Layout

To edit a keyboard layout, select the keyboard layout, then click Properties. The Edit Keyboard dialog contains the following elements:

##### Edit Keyboard Elements

Dialog Element | Description
--- | ---
Name | The name of the keyboard layout. This name is displayed in the Keyboards tabbed section of the Preferences dialog.
Label | A short label for the keyboard layout. For example, the label for a United States English keyboard layout is us. By default, the applet displays the flag and label of the current keyboard layout in the applet display.

Command

The command that the applet uses to change to the keyboard layout. You can use any of the following commands to change the keyboard layout:

`gkb_xmmap us` where us is the file extension of the `xmodmap` file for the keyboard layout.

`xmodmap /path/xmodmap.us` where /path/xmodmap.us is the `xmodmap` file for the keyboard layout.

`setxkbmap us` where us is the file extension of the `xmodmap` file for the keyboard layout.

Flag | The flag that represents the country in which the keyboard layout is used. By default, the applet displays the flag and label of the current keyboard layout in the applet display. Click on the flag to display a flag selector dialog.

### Options

Appearance

  Select one of the following options from the drop-down list to specify what the applet displays in the panel:

  - Flag

    Display a flag only.

  - Label

    Display a label only.

  - Flag and Label

    Display a flag and label.

  You must reboot your machine to effect a change to this setting.

Switch layout

  You can use a shortcut key to switch between keyboard layouts. To customize the shortcut key, click Grab keys, then press the keys that you want to use. The applet displays the shortcut key in the text box.