IMPORTANT NOTES:  For EventSharing to work after a logout and login, you MUST add the EventSharingHelper application to your Login Items.  See below for more info.

Also should you be running PointRight Sender, and need to force the mouse back to the local machine (and mousing off the remote screen fails), Press Command-Control-Q, and local control will be re-established.

---

OVERVIEW:

EventSharing consists of three distinct applications that allow your computer to participate in an interactive workspace environment:

MultiBrowse allows you to send and receive URLs to and from other computers.  You can display a URL on another computer, or another user can cause your browser to display a URL.

PointRight allows you to use one computer's mouse and keyboard to control other computers.  You can use your mouse and keyboard to control one or more other computers, or you can let other computer's mouse and keyboard control your computer.

iClipboard allows you to share your system clipboard with other computers.  All machines running iClipboard and connected to the same EventHeap server will update their clipboards to the text data most recently "cut" or "copy".   Do not run iClipboard unless you are willing to have other users access and change your clipboard!

All applications require a network connection to a running EventHeap server to operate.

---

BACKGROUND:

This is a Mac OS X port of the iROS package (Interactive Room Operating System) developed by the Stanford Interactive Workspaces project.  See http://iwork.stanford.edu for more info and software for other platforms.

---

USING EVENTSHARING:

EventSharing is controlled from the EventSharing PreferencePane in System Preferences.

First, an EventHeap server machine must be specified.  This can be done automatically (if you're using Mac OS X 10.2, which has Rendezvous), or manually.  For example, in the Stanford iRoom, the EventHeap server machine is "iw-room2.stanford.edu".

Then, before turning on any given EventSharing application, the parameters for that application must be specified:

MultiBrowse Sender requires a WebDAV server in order to share files.  In the iRoom, this is "http://iw-file.stanford.edu/tmp/" (the final slash is required)

MultiBrowse Receiver requires a unique name for this machine.  This is usually the same as your File Sharing name.

PointRight Sender requires a file to specify the topological layout of the computers to be controlled.  A sample layout file is installed in /Library/Preferences/PointRightLayouts/pr_default.jph.  To use a different layout, copy this file, modify it, and change the specified layout file to the name of your new file.

PointRight Receiver requires a unique name for this machine.  This is usually the same as your File Sharing name (and the MultiBrowse Receiver name).  It is referred to in the PointRight layout file.

iClipboard requires no special configuration, and just needs to be started or stopped when you wish.

Once parameters are specified, you can turn on a given application by clicking on the button next to its name.  MultiBrowse Sender and MultiBrowse Receiver can be on at the same time, but only one of PointRight Sender or PointRight Receiver can be on at once.

---

THE HELPER APPLICATION:
 
For EventSharing to work, the EventSharingHelper application must be running.  This installer will launch the EventSharingHelper application once installation is finished.  However, if you logout, the EventSharingHelper application will no longer be running.  For EventSharing to work after a logout, you must put the EventSharingHelper application in your Login Items (in System Preferences).

The helper application is called "EventSharingHelper" and will be installed in your Applications directory.  Do not double click on the EventSharingHelper application directly, because this may cause it to be running twice, which will be confusing.

The EventSharingHelper application runs in the background, so it is never visible in the Dock, even when it is running.  If you wish to check whether it is running, you can use the Process Viewer utility in /Applications/Utilities.  You can also use Process Viewer to quit the helper (if, for example, you have accidentally launched a second copy).

---

INSTALLATION INFORMATION:

To install EventSharing, run the EventSharing installer package ("EventSharing.pkg").

What is installed and where:
/Applications/EventSharingHelper.app
/Library/PreferencePanes/EventSharing.prefPane
/Library/Preferences/iwork.EventSharing.plist
/Library/Preferences/PRLayouts/default.jph

---

VERSION HISTORY:

1.3 (Dec-11-02)
- Added iClipboard functionality and UI to the PrefPane (iClipboard is still text only).
- Increased the timeout before it is determined that the EventHeap server is down (from 5 seconds to 10).
- Added an "Emergency Exit" to PointRight Sender (Cmd-Control-Q is trapped to return local control).
- Delete buttons UI changed slightly.
- Fixed the bug where a PointRight Sender can "lock" a modifier key on the Receiver.

1.2 (11-4-02)
- fixed bug that caused PointRight to misbehave when the layout file could not be found
- more robust when the EventHeap server cannot be found
- many UI changes (combo boxes w/Delete buttons, Verify, Browse, Edit buttons, Tooltips)
- added default Prefs
- EventSharing app now called EventSharingHelper
- installer now launches EventSharingHelper (you still need to set Login Items for it to work across a logout/login)

1.1.5 (10-20-02)
- made a pretty icon
- improved ReadMe

1.1.4 (9-20-02)
- fixed incompatibility bug with 10.2 which caused PointRight mouse button to not work

1.1.3 (9-19-02)
- fixed bug in MultiBrowse sender that would cause it to occasionally crash
- MultiBrowse sender now has no Dock icon
- MultiBrowse sender now alphabetizes receiver list so it doesn't change order during refresh
- MultiBrowse sender can be quit using close box, and Pref Pane is updated accordingly

1.1r2 (9-13-02)
- fixed major bug: EventSharing applications would sometimes not launch

1.1r1 (9-9-02)
- package installer
- added Rendezvous support : NOW REQUIRES 10.2
- improved Pref Pane GUI
- MultiBrowse sender GUI improved:
  * receiver list refreshed automatically every 3 seconds, making manual refresh button obsolete
  * text field automatically disables during drag, making manual disable button obsolete
  * behaves more like a utility window

1.0a8 (8-30-02)
Minor bug fixes.

1.0a7 (8-14-02)
Stable release.

1.0a6 (?)
Bug fixes.

1.0a5 (7-22-02)
First release installed in Vining.

1.0a4 (?)
Minor improvements.

1.0a3 (7-17-02)
More improvements.  MultiBrowse added.

1.0a2 (7-11-02)
Minor improvements.  Still no MultiBrowse.

1.0a1 (7-9-02)
Initial release.  No MultiBrowse.