NAME

SYNOPSIS

DESCRIPTION

RESOURCES

OPTIONS

-display [displayname]

This option specifies the name of the X server to use.

-geometry [+X+Y]

This option specifies the placement of the window on the screen.

-name [name]

This option specifies the name of the application.

-background [color], -bg [color]

This option specifies background color of the window.

-h, -help

Output help message.

-readme

Output README for informations and examples about using XKeyWrap.

-copyright

Output COPYRIGHT of XKeyWrap.

-p, -play

XKeyWrap starts playing key sequence at start.

-r, -repeat

Set auto repeat mode at start.

-rec, -record

XKeyWrap starts recording key sequence at start.

-pause

XKeyWrap is paused at start.

-q, -quit

XKeyWrap exits when child process exits. And Child process exits when XKeyWrap exits.

-f, -file [filename]

This option specifies file to save and load key sequence.

-s, -speed [speed]

This option specifies speed to play key sequence from 0 to 9. Default speed is 5.

-output-display [displayname]

This option specifies the display to send key sequence.

-output-window [windowid]

This option specifies the window to send key sequence.

-x [Application [Application options...]]

An application starts as child process of XKeyWrap and XKeyWrap is connected to the application and send key sequence to it. (Ex. xkeywrap -x emacs sample.txt)

MENU

Select

Select the window to output key sequence. Move the mouse pointer to the window and click left button on the window.

Parent

Change the window to output key sequence to the parent of the window.

Child

Change the window to output key sequence to one of the children of the window.

Next

Change the window to output key sequence to other child. This menu is selected next to selecting Child menu.

Clear

Clear the recorded key sequence data.

Record

Start recording key sequence from the keyboard. If key sequence data exists, XKeyWrap add key sequence to the start of the old key sequence data. If you select this menu while recording, XKeyWrap adds key sequence to the end of the old key sequence data. If you select this menu while playing, you can insert key sequence into the old key sequence data.

Stop

Stop recording and playing.

Play

Play the recorded key sequence in real time. If you select this menu while playing, XKeyWrap increases the times of playing.

Pause

Pause recording or playing.

Repeat

Auto repeating at playing the recorded key sequence.

+

Change the speed to play key sequence faster.

-

Change the speed to play key sequence more slow.

Save

Save the recorded key sequence data to file.

Load

Load the key sequence data from file.

Quit

XKeyWrap exits.

EXAMPLES

% xkeywrap

- XKeyWrap starts.
- Click Select menu of XKeyWrap and click on the window to send key sequence.
- Key inputs to XKeyWrap are sent to the window.

% xkeywrap -x emacs

- Emacs and XKeyWrap start.
- You put the mouse pointer on XKeyWrap and input some words.
- The words are sent to emacs.
- You can record and play the key sequence by XKeyWrap.

% xkeywrap -f example.dat -x emacs -geometry 80x20 text.txt

- Emacs opens file "text.txt" and starts with 80x20 window.
- XKeyWrap starts. If example.dat exists, XKeyWrap reads it.
- If you select Play menu, XKeyWrap plays it.
- If you select Save menu, XKeyWrap saves key sequence to file "example.dat".

% xkeywrap -display wrongdisp:0 -output-display gooddisp:0

- XKeyWrap starts on "wrongdisp".
- Click Select menu of XKeyWrap and click on the window on "gooddisp".
- Key inputs to XKeyWrap are sent to the window on "gooddisp". (XKeyWrap can send key sequence to an application running on other X server over the network)

% xkeywrap -f example.dat -display wrongdisp:0 -output-display gooddisp:0 -x emacs -display gooddisp:0 -geometry 80x20 text.txt

- Emacs starts on "gooddisp".
- XKeyWrap starts on "wrongdisp".
- XKeyWrap search a new window on "gooddisp", and find emacs on it.
- Key inputs to XKeyWrap are sent to emacs. (XKeyWrap can send key sequence to an application running on other X server over the network)

Q AND A

Q. I cannot connect XKeyWrap to XTerm (or other application).

XTerm do not permit to receive event from outside as default.
If you want to use XTerm with XKeyWrap, you have to set allowSendEvents resource. add this line to .Xdefaults.
XTerm*allowSendEvents: true
or
xterm*allowSendEvents: true
But, if allowSendEvent is true, XTerm receives all events from outside, and everyone can operate XTerm on your machine from the machine which is permitted to connect to the X server of your machine by xhost(1). If you do it, be very careful of setting xhost(1).
If you want to permit to connect XKeyWrap to all applications, add this line to .Xdefaults.
*allowSendEvents: true
But, when you do it, all X applications receives all events from outside, and everyone can operate them on your machine from the machine which is permitted to connect to the X server of your machine by xhost(1). If you do it, be very careful of setting xhost(1).

Q. I read term of Demonstration in README and try it, but it does not run correctly.

This demonstration was recorded with Japanese 106 keyboard. If your keyboard is different from it, you can see this demonstration, but, this demonstration runs more or less curiously.

Q. Though allowSendEvents resource is set correctly, I cannot connect XKeyWrap to an application.

Try Parent menu as below,
first, click Select menu and select the application window.
Second, put the mouse pointer on XKeyWrap and try to hit some keys.
Third, if you cannot operate the application from XKeyWrap, click Parent menu some times and try to hit some keys again.

SEE ALSO

BUGS

AUTHOR

COPYRIGHT