gok(1) User Commands gok(1)
gok - GNOME on-screen keyboard
gok [--access-method=name] [--editor] [--extras] [--geometry=geometry] [--help] [--input-
device=device] [--keyboard=keyboard] [--list-accessmethods] [--list-actions] [--login]
[--remembergeometry] [--scan-action=string] [--select-action=string] [--settings]
[--usage] [--valuator-sensitivity=double] [gnome-std-options]
The GNOME On-screen Keyboard (GOK) is a dynamic on-screen keyboard for UNIX and UNIX-like
operating systems. gok enables users to control their computer without having to rely on a
standard keyboard or mouse. Many individuals must control the computer using alternative
input methods. With the right hardware support and gok, individuals have full access to
applications that support the AT SPI, and therefore, full access to the functionality that
these applications provide.
The following options are supported:
-a, --access-method=name Use the specified access method. name is a string and can
be found in the various access method files (.xam)
assigned to the "name" property of the <gok:accessmethod>
tag. Note that this is not necessarily the same as the
name of the .xam file, see --list-accessmethods.
-e, --editor Start the GOK keyboard editor.
--extras Use special, but possibly unstable, gok functionality.
--geometry=geometry If --geometry is not specified, gok remembers its position
between invocations and starts in the same position as
when last shut down.
If --geometry is specified, gok positions itself within
the rectangular area of screen described by the given X11
geometry specification, but does not remember its position
when shut down. This behavior can be changed with the
--remembergeometry option, which forces gok to remember
its position when shut down, even when started with
--help Displays the command line options.
-i, --input-device=device Use the specified input device.
-k, --keyboard=keyboard Start GOK with the specified keyboard.
--list-accessmethods List the access methods that can used as options to other
--list-actions List the actions that can used as options to other argu-
-l, --login Specify that GOK is used to log in.
--remembergeometry Can be used with the --geometry option. Forces GOK to
remember its position when shut down, even if started with
the --geometry option. See --geometry.
--scan-action=string Start GOK and hook this action to scan operations. See
--select-action=string Start GOK and hook this action to select operations. See
-s, --settings Open the settings dialog box when GOK starts.
--usage Displays a brief usage message.
---valuator-sensitivity=double A multiplier to be applied to input device valuator events
gnome-std-options Standard options available for use with most GNOME appli-
cations. See gnome-std-options(5) for more information.
GOK features Direct Selection, Dwell Selection, Automatic Scanning and Inverse Scanning
access methods, and includes word completion.
GOK includes an alphanumeric keyboard and a keyboard for launching applications. Key-
boards are specified in XML, enabling existing keyboards to be modified and new keyboards
to be created. The access methods are also specified in XML, providing the ability to mod-
ify existing access methods and create new ones. GOK is not limited to presenting key-
boards that have been designed by hand, and can dynamically create keyboards to adapt to
the user's current situation.
GOK can redisplay components of the user interfaces of running applications directly
within GOK as keyboards. This provides efficient access to elements of the user interface,
removing the need to navigate the interface indirectly though keyboard accelerators. GOK
supports the redisplay of application menus and toolbars. GOK contains a window activator
keyboard that lists the current windows on the desktop and provides the ability to switch
Users have the option of setting key width, height, and spacing as well as visual and
auditory feedback on highlighting and selection. GOK can be further customized if you have
programming skills, and contributions are welcome.
If you build GOK from source, you can find some documentation about the internal GOK APIs
in the gok/docs/reference/html directory.
Note: Although GOK can be operated via the "core pointer" device, that is, the system
mouse or a device that controls the primary onscreen pointer, this mode of operation is
not supported or recommended for most users. This is because the operating system and pri-
mary GUI toolkits reserve the core pointer for their own use, resulting in conflicts with
GOK that can "lock out" a GOK user who cannot activate the keyboard or use the core
pointer to "point and click" in the usual way. GOK can be operated via "auxiliary" input
devices, which act as secondary or additional button or pointing devices. See the GOK
online reference manual and the GNOME Accessibility Guide for more information on how to
configure GOK to use auxiliary input devices.
Example 1: Specifying an Access Method to Use for GOK
example% gok --access-method=dwellselection
Example 2: Automatically Open the GOK Preferences Dialog When GOK Starts
example% gok --settings
The following exit values are returned:
0 Application exited successfully.
1 Application exited with error.
2 GOK cannot be initialized from configuration data.
The following files are used by this application:
/usr/bin/gok Executable for GNOME on-screen keyboard
/usr/share/gok/*.kbd GOK branching keyboards (C locale)
/usr/share/gok/*.xam Access Method definition files
/usr/share/gok/locale/*.kbd Localized GOK branching keyboards
/usr/share/gok/dictionary.txt Primary GOK word-completion dictionary
/usr/share/gok/*.png Image files for GOK branching keyboards
/usr/share/gok/goksound*.wav Example GOK audio feedback
/usr/share/gok.rc GtkRC file defining GOK color scheme
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|Availability |SUNWgnome-a11y-gok |
|Interface stability |Volatile |
GOK online reference manual.
Latest version of the GNOME Accessibility Guide for your platform.
Latest version of the GNOME Desktop User Guide for your platform.
Written by Bill Haneman and David Bolter, Sun Microsystems Inc., 2004, 2006, 2007.
SunOS 5.11 12 Nov 2007 gok(1)