FEATURES

* Supervise the activity of the students (view student screens)
* Lock student screens
* Broadcast the teacher screen to students (all students or a subset) fullscreen
  or in a window (this feature uses multicast therefore can scale to many
  computer very well)
* Control remotely a student computer
* Run a script for every student computers
* Compatible with any Java compatible OS (default configuration is for Linux)

REQUIREMENTS

In order to use this application every computer need to have a VNC server 
installed. ( see http://www.realvnc.com or http://www.tightvnc.com/)

Under Linux it is advisable to use the VNC module for the X11 server which is 
included with the VNC version distributed by http://www.realvnc.com. Under 
Fedora the VNC module is included in the package vnc-server.

USAGE

1) start a VNC server on every computer (teacher and students)

   - all the vnc servers on the student machines have to be configured
     with the same password

2) Create a configuration file for the student modules (an example is provided)

3) Start the student module on the student computers

   java -jar student.jar

   --- or ---
  
   double click on student.jar

   The configuration will be loaded from the file "student.properties" in 
   the current directory.

4) Start the teacher module on the teacher computer, configuration options will
   be asked.

   java -jar teacher.jar

   --- or ---

   Double click on teacher.jar

CONTACT

This software is currently being tested in a real environment, an improved
version will probably be made available next Summer (2007).

For any feedback contact me at <lorenzo.keller@gmail.com>


LICENSE

Teacher 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 of the License, or
(at your option) any later version.
Teacher is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.


KNOWN BUGS

* Sometimes the student module looses connection from the server requiring a
  restart

* Multicast ttl is not correctly set by default

* Locking under windows don't work

* Sometimes student names are not shown (on linux)

* Student names can't be queried on windows

CREDITS

This software is released under the GPL (see source files for details)

Copyright 2006 Lorenzo Keller <lorenzo.keller@gmail.com>

This software includes code from:

Copyright (C) 1996 by Jef Poskanzer <jef@acme.com>
Copyright (c) 1996 Widget Workshop, Inc
Copyright (C) 1999 AT&T Laboratories Cambridge
Copyright (C) 2000 Tridia Corporation
Copyright (C) 2001,2002 Constantin Kaplinsky
Copyright (C) 2001-2004 HorizonLive.com, Inc
 
Please read notes in the source files
