Installing CollaboRhythm.Tablet

Note: these instructions are currently incomplete. Until we setup a server with the data you need, or you setup one yourself, you will not be able to run CollaboRhythm.

You can either download the latest CollaboRhythm.Tablet installer or build it yourself from source. For more information on getting and building the source, see Preparing Your Machine for CollaboRhythm Development. The instructions below are for downloading and installing the latest pre-built version of CollaboRhythm.

Pre-Requisites:

• A tablet, such as the Motorola Xoom, running Android 2.2 (?) or version of Android that supports the latest version of Adobe AIR. At the time of this writing (January 2012) Adobe AIR 3.1 is required.
• A computer with drivers that will let you connect to your Android tablet and install the APK. You will also need to have the Android SDK installed.
• An internet connection (currently, CollaboRhythm requires a live connection to run)

Instructions:

1. Install Adobe AIR from the Android Market.

2. Download the latest version of CollaboRhythm.Tablet from https://github.com/newmediamedicine/CollaboRhythm/downloads

3. Extract the files from the zip archive.

4. Create a file named settings.xml.

5. Edit the settings.xml and specify valid settings using the following format. Note that the settings below are not valid as-is. You will need to have a server setup with Indivo X and the correct data, details of which are not yet documented or provided here:

<?xml version="1.0" encoding="utf-8"?>
<settings xmlns="http://collaborhythm.org/application/settings"\>
<mode>clinician</mode>
<indivoServerBaseURL>http://your.indivo.server:port </indivoServerBaseURL>
<username>your-username</username>
<password>your-password</password>
<rtmpBaseURI>rtmp://your.collaboration.server</rtmpBaseURI>
<useFileTarget>true</useFileTarget>
<useTraceTarget>true</useTraceTarget>
<useSyslogTarget>true</useSyslogTarget>
<syslogServerIpAddress>your.syslog.server</syslogServerIpAddress>
<debuggingToolsEnabled>false</debuggingToolsEnabled>
<useSingleScreen>true</useSingleScreen>
<!--
useSingleScreen - If no valid windowSettings.xml file exists or resetWindowSettings = true, then force the app to only use a single screen (one window)
resetWindowSettings - Ignore the windowSettings.xml and reset the position/size of all windows
<useSingleScreen>true</useSingleScreen>
<resetWindowSettings>true</resetWindowSettings>
targetDate can be used for a demo to change the current date
<targetDate>2011-08-13T10:40:00-5:00</targetDate>
-->
</settings>

6. Save your changes.

7. Deploy your settings and install the APKs CollaboRhythm.Tablet.apk and CollaboRhythm.Android.DeviceGateway.apk. On Windows, you can do this by running the provided script CollaboRhythm.Tablet.install.bat.