XKeyWrap - Record and play key sequence.

XKeyWrap Copyright (C) 1999-2001 Sakai Hiroaki.
All Rights Reserved.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

XKeyWrap is a wrapper of key sequence between keyboard and an application
(ex.emacs).
XKeyWrap can record and play key sequence in real time.
And XKeyWrap can send key sequence to an application on other X server
over the network.

What's XKeyWrap?

Have you think this?

When you wrote a program with using cut-and-paste as below :

    #inclde <stdio.h>
    #inclde <stdlib.h>
    #inclde <string.h>
    #inclde <signal.h>
    #inclde <locale.h>
    #inclde <math.h>
    #inclde <time.h>
    ...

You notice miss typing "inclde", and should push key,

    u, Down, Left, u, Down, Left, u, Down, Left, u, Down, Left, ...

You say, "Is there an application to repeat those key input sequence?"

It is XKeyWrap!

Have you think this?

You want to see a good programmer writing a program in real time. But,
You cannot always be beside him.

You say, "Is there an application to record and play his key input sequence?"

It is XKeyWrap!

Have you think this?

You have two UNIX systems on which X Window Systems are running.
But, you fill inconvenience to use two keyboards alternately.

You say, "I want to operate two displays with one keyboard. Is there an
application to input from one keyboard and send key sequence to the selected
display?"

It is XKeyWrap!

Have you think this?

You have two UNIX systems on which X Window Systems are running.
One system have a good keyboard, but a wrong display. Another system have
a good display, but a wrong keyboard.

You say, "I want to use the good keyboard and the good display. Is there
an application to input from the good keyboard and send key sequence
to the good display?"

It is XKeyWrap!

XKeyWrap wraps key sequence between keyboard and an application (Ex. emacs).

Features :

    * XKeyWrap can record key sequence and play it in real time.
    * XKeyWrap can record key sequence and repeat it.
    * XKeyWrap can run over the network.
      (XKeyWrap can send key sequence to an application running on
       other X server over the network)

Synopsis :

    xkeywrap [XKeyWrap's options] [-x Application [Application's options...]]

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)

Demonstration :

    If you want to see a demonstration of XKeyWrap,
    get demo.dat and xkeywrap_demo.c from

        http://www.seki.ee.kagu.sut.ac.jp/~sakai/myfreesoft/index.html

    and type as below

        % xkeywrap -p -s 2 -f demo.dat -x emacs -geometry 80x25 xkeywrap_demo.c

    Then, XKeyWrap starts the demonstration "Making of XKeyWrap".

    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.

Options, Resources, and Menu :

    See the manual page of XKeyWrap for details of options, resources,
    and menu. Install XKeyWrap and type "man xkeywrap".

Bugs :

XKeyWrap runs more or less curiously between systems with different keyboards.
(Ex. If the keyboard of your system is 101 keyboard,
 XKeyWrap can play the data recorded with Japanese 106 keyboard, but,
 more or less curiously)

Author :

XKeyWrap was programed by Sakai Hiroaki.
If you want to contact to the author, send E-Mail to

    E-Mail : sakai@seki.ee.kagu.sut.ac.jp, hsakai@m8.people.or.jp

If you want to get the newest XKeyWrap or other free softwares, See

    http://www.seki.ee.kagu.sut.ac.jp/~sakai/myfreesoft/index.html
    http://hp.vector.co.jp/authors/VA014157/myfreesoft/index.html
    http://www.people.or.jp/~hsakai/myfreesoft/index.html

End of README.
