README for keysender version 1.0 - August 2, 2001

INTRODUCTION

keysender is a very simple program that can be used to send arbitrary
keystrokes to windows under X. Windows are specified by window title. (The
window title is the string displayed in the window decorations by your window
manager) Currently, the first window whose title contains the given string is
used. Keys are given as X Keysyms.

The program was written by Robert Ricci (ricci@xrob.org)

BUILDING

Just run 'make'. keysender was developed and tested on FreeBSD 4.3 - no other
platforms have been tested at this time. I suspect that it should compile with
little or no modification on most other popular UNIX platforms.

USAGE

keysender [-r] [-d] <window title> <keysym ...>

The -d option turns on some debugging output

The -r option causes causes a KeyRelease event to be sent after each KeyPress
event. Some programs require this in order for the key to be registered
properly.

<window title> is a string that will be used to find the target for the
keypress. This string is case sensitive, and the only first window found whose
title contains it will be used.

<keysym ...> is a list of (at least one) keys to be sent. A list of Keysyms can
be found on most systems in /usr/X11R6/include/X11/keysymdef.h . 

EXAMPLES

keysender -r MPlayer p (sends 'p' to an MPlayer window)
keysender rxvt l s space slash Return (sends 'ls /' and a carriage return to
		an rxvt window)