xzibit is a per-window VNC system.
Its development is supported by Collabora Ltd.

A. Instructions:

1. make sure you have wmctrl, xlogo, libvncserver,
   Xephyr, and gtk-vnc installed.
   (some of these are checked by autotools,
    some of them aren't yet.)
2. run ./autogen.sh
3. run make install
4. if your mutter is expecting plugins in /usr/lib, you
   may need to run

       sudo cp /usr/local/lib/mutter/plugins/xzibit.so \
           /usr/lib/mutter/plugins/
 
   (this should really be done in autotools)

5. use gconf-editor to set
       /apps/mutter/general/clutter_plugins
   to a list containing the string
       xzibit

6. run xzibit-demo

That's all to be going on with.

B. More details:

xzibit-demo calls xzibit-run with some useful arguments.
xzibit-run launches two Xephyrs, :3 and :4, and sets
up a mutter instance on both of them.  It then runs
xzibit-autoshare on :3.  xzibit-autoshare automatically
sets itself as shared after a few seconds.  This should
cause it to appear on :4 as well.

For more information, read the protocol document in doc/.

C. What's left to do:

Vital:

 * Telepathy support.  At present it only works across
   the loopback interface.  The next release will
   send the windows over Tubes.
 * Getting xinput2 support fully working, so we can fake
   mouse clicks and keypresses on arbitrary windows.
 * "Doppelganger" pointers, i.e. ones which track the
   movement on the other display.

Less important:

 * Audio support.  This is partly-written in a branch.

D. Toggling sharing of windows

xzibit-toggle is a simple program to let you click on
a window and share it (or unshare it).

E. The envelope patch

There is a patch, not supplied here, to add an envelope
button to mutter's window decorations.  This button
changes colour to reflect the sharing status of the
window.  When pressed, it runs the src/xzibit-share
script.  This patch can't currently be done in a plugin,
and since there are slightly less convenient but much
less intrusive ways to do the same thing, I left it out.
It may be better to do this using Canonical's "windicators"
idea.

F. Where to find more information

 * http://telepathy.freedesktop.org/wiki/Xzibit
 * http://git.collabora.co.uk/?p=user/tthurman/xzibit/.git
 * mailto:thomas.thurman@collabora.co.uk