README
1XKeyWrap - Record and play key sequence.
2
3XKeyWrap Copyright (C) 1999-2001 Sakai Hiroaki.
4All Rights Reserved.
5
6This program is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
8the Free Software Foundation; either version 2, or (at your option)
9any later version.
10
11XKeyWrap is a wrapper of key sequence between keyboard and an application
12(ex.emacs).
13XKeyWrap can record and play key sequence in real time.
14And XKeyWrap can send key sequence to an application on other X server
15over the network.
16
17What's XKeyWrap?
18
19Have you think this?
20
21When you wrote a program with using cut-and-paste as below :
22
23 #inclde <stdio.h>
24 #inclde <stdlib.h>
25 #inclde <string.h>
26 #inclde <signal.h>
27 #inclde <locale.h>
28 #inclde <math.h>
29 #inclde <time.h>
30 ...
31
32You notice miss typing "inclde", and should push key,
33
34 u, Down, Left, u, Down, Left, u, Down, Left, u, Down, Left, ...
35
36You say, "Is there an application to repeat those key input sequence?"
37
38It is XKeyWrap!
39
40Have you think this?
41
42You want to see a good programmer writing a program in real time. But,
43You cannot always be beside him.
44
45You say, "Is there an application to record and play his key input sequence?"
46
47It is XKeyWrap!
48
49Have you think this?
50
51You have two UNIX systems on which X Window Systems are running.
52But, you fill inconvenience to use two keyboards alternately.
53
54You say, "I want to operate two displays with one keyboard. Is there an
55application to input from one keyboard and send key sequence to the selected
56display?"
57
58It is XKeyWrap!
59
60Have you think this?
61
62You have two UNIX systems on which X Window Systems are running.
63One system have a good keyboard, but a wrong display. Another system have
64a good display, but a wrong keyboard.
65
66You say, "I want to use the good keyboard and the good display. Is there
67an application to input from the good keyboard and send key sequence
68to the good display?"
69
70It is XKeyWrap!
71
72XKeyWrap wraps key sequence between keyboard and an application (Ex. emacs).
73
74Features :
75
76 * XKeyWrap can record key sequence and play it in real time.
77 * XKeyWrap can record key sequence and repeat it.
78 * XKeyWrap can run over the network.
79 (XKeyWrap can send key sequence to an application running on
80 other X server over the network)
81
82Synopsis :
83
84 xkeywrap [XKeyWrap's options] [-x Application [Application's options...]]
85
86Examples :
87
88 % xkeywrap
89
90 - XKeyWrap starts.
91 - Click Select menu of XKeyWrap and click on the window to send key
92 sequence.
93 - Key inputs to XKeyWrap are sent to the window.
94
95 % xkeywrap -x emacs
96
97 - Emacs and XKeyWrap start.
98 - You put the mouse pointer on XKeyWrap and input some words.
99 - The words are sent to emacs.
100 - You can record and play the key sequence by XKeyWrap.
101
102 % xkeywrap -f example.dat -x emacs -geometry 80x20 text.txt
103
104 - Emacs opens file "text.txt" and starts with 80x20 window.
105 - XKeyWrap starts. If example.dat exists, XKeyWrap reads it.
106 - If you select Play menu, XKeyWrap plays it.
107 - If you select Save menu, XKeyWrap saves key sequence to file
108 "example.dat".
109
110 % xkeywrap -display wrongdisp:0 -output-display gooddisp:0
111
112 - XKeyWrap starts on "wrongdisp".
113 - Click Select menu of XKeyWrap and click on the window on "gooddisp".
114 - Key inputs to XKeyWrap are sent to the window on "gooddisp".
115 (XKeyWrap can send key sequence to an application running on
116 other X server over the network)
117
118 % xkeywrap -f example.dat -display wrongdisp:0 \
119 -output-display gooddisp:0 -x emacs -display gooddisp:0 \
120 -geometry 80x20 text.txt
121
122 - Emacs starts on "gooddisp".
123 - XKeyWrap starts on "wrongdisp".
124 - XKeyWrap search a new window on "gooddisp", and find emacs on it.
125 - Key inputs to XKeyWrap are sent to emacs.
126 (XKeyWrap can send key sequence to an application running on
127 other X server over the network)
128
129Demonstration :
130
131 If you want to see a demonstration of XKeyWrap,
132 get demo.dat and xkeywrap_demo.c from
133
134 http://www.seki.ee.kagu.sut.ac.jp/~sakai/myfreesoft/index.html
135
136 and type as below
137
138 % xkeywrap -p -s 2 -f demo.dat -x emacs -geometry 80x25 xkeywrap_demo.c
139
140 Then, XKeyWrap starts the demonstration "Making of XKeyWrap".
141
142 This demonstration was recorded with Japanese 106 keyboard.
143 If your keyboard is different from it, you can see this demonstration,
144 but, this demonstration runs more or less curiously.
145
146Options, Resources, and Menu :
147
148 See the manual page of XKeyWrap for details of options, resources,
149 and menu. Install XKeyWrap and type "man xkeywrap".
150
151Bugs :
152
153XKeyWrap runs more or less curiously between systems with different keyboards.
154(Ex. If the keyboard of your system is 101 keyboard,
155 XKeyWrap can play the data recorded with Japanese 106 keyboard, but,
156 more or less curiously)
157
158Author :
159
160XKeyWrap was programed by Sakai Hiroaki.
161If you want to contact to the author, send E-Mail to
162
163 E-Mail : sakai@seki.ee.kagu.sut.ac.jp, hsakai@m8.people.or.jp
164
165If you want to get the newest XKeyWrap or other free softwares, See
166
167 http://www.seki.ee.kagu.sut.ac.jp/~sakai/myfreesoft/index.html
168 http://hp.vector.co.jp/authors/VA014157/myfreesoft/index.html
169 http://www.people.or.jp/~hsakai/myfreesoft/index.html
170
171End of README.
172