1# Client
2
3This dir contains various "client"-type programs that aren't really part
4of ctwm, but may be useful adjuncts to it, or possible skeletons for
5future useful adjuncts.  These programs are generally not maintained or
6vetted to the same degree as ctwm itself, and are provided mostly for
7special-case uses or as examples.
8
9Use at your own risk.
10
11## Building
12
13This directory is not built by default.  To enable it, set the
14`DO_CLIENT` flag in your `cmake` invocation.  e.g.,
15
16    % make CMAKE_EXTRAS="-DDO_CLIENT=ON"
17
18## Roadmap
19
20A quick summary of the things in here
21
22libctwmc
23:       A library for some routines potentially useful for querying info
24        about a running `ctwm` instance.
25
26demolib
27:       A small program that links against `libctwmc` and demonstrates a
28        few of its functions.  It probably won't work at all, and won't
29        work right unless you're Claude with Claude's config and windows.
30
31gtw
32:       A small program to switch to a workspace or change a window's
33        occupation from the command line.  Doesn't use `libctwmc`.
34
35forward
36:       A standalone utility that attempts to forward events from
37        "desktop environment" style desktop windows to the real root
38        window, so that a ctwm running in those sorts of environments can
39        get access to the keystrokes/mouseclicks.  Appears to generally
40        not _quite_ work right in most cases.  May be a simple fix, but
41        nobody has spent enough time to find it.
42
43
44{>>
45 vim:expandtab:ft=markdown:
46<<}
47