README, 2006-09-02
==================

This widget is an all-in one Citrix Metaframe client based on the Citrix Java Client components.

It is designed to enable you to access Citrix sessions in seamless mode in Mac OS X without installing any extra software, provided you know the IP address and application name beforehand.

This is NOT a Citrix-endorsed client. As such, it is not supported by them (nor, in fact, by myself), and was only developed so that I could run Citrix sessions in seamless mode on my Macs (the native Mac OS X client does not support seamless mode, and is now extremely outdated - there isn't even a Universal binary version).

Despite having tried to contact them (see http://the.taoofmac.com/space/blog/2006-03-13 for more details), I have been unable to obtain formal permission to re-distribute their Java Client components, which means that despite being based on a freely available piece of software, this is not a sanctioned use of that software.

As such, I am only distributing this as a sort of integration experiment, and make no claims as to the future of this software. I can stop distributing it at any moment, and only have decided to publish and keep updating it because I keep getting requests from people for whom the current Mac OS X client is unsuitable.

Features/Bugs/Known Issues:
---------------------------

* The Java security warning dialogue pops up behind most windows, causing some users to believe the widget does not work.
* Some people complain of not being able to get a seamless session (i.e., with Citrix windows overlapping with Mac OS X windows). This is most likely due to their Citrix server configuration (i.e., it is in "desktop" mode and serves a complete desktop environment rather than a single application).
* Cmd-Tab task switching does not let you switch to Citrix windows. Expose, however, works (although Citrix windows are not correctly re-painted).
* There is no support for multiple sessions. Upon re-hashing the widget for 10.4.6, I ported it to Widgetarium (http://projects.gandreas.com/widgetarium/index.html) and got support for multiple widgets, which is enough for me. 
* No support whatsoever for application browsing, .ica files, etc. This is a straightforward TCP-only client that connects to port 1494 of whatever server you designate.
* Input fields occasionally become locked upon closing a session (I have no idea why, even after poking at this with a DOM inspector)
* There is no way to set the bit depth (this can be done by changing the DesiredColor parameter in the .js file, but I have no use for it.)

You can report more issues to rui.carmo@gmail.com. However, please understand that I will most likely not do anything about them, since this is little more than an experiment.

Disclaimer
==========

This is a COMPLETELY UNSUPPORTED piece of software, that you agree to run (and use) at your own risk. Neither Citrix nor myself can be held liable for any issues you may encounter.

History
=======
2006-04-09 - first public release
2006-09-02 - Updated JAR files to version 9.4, permanently enabled the JARs for printing and local file access

License
=======

Despite the fact that the Citrix Java components are proprietary software and that the widget now includes Widgetarium extensions, all remaining files in this widget (graphics, HTML and JavaScript) are distributed according to the Creative Commons Attribution-NonCommercial-NoDerivs 2.0 license (http://creativecommons.org/licenses/by-nc-nd/2.0/).