# Release Notes - okapi-apps 0.37, Apr-06-2019

- Overview
- Windows Platform
- Linux Platforms
- MacOS Platform
- Support

## Overview

The okapi-apps distribution contains:

- The okapi-lib distribution, a collection of Java classes design to help in programming components and applications related to translation and localization tasks.
- Several applications built on top of the framework:
  - Tikal is a command-line tool to execute some simple localization-related tasks, like extraction and merge of XLIFF documents.
  - Rainbow is an application that provides a user interface to launch different translation and localization-related utilities.
  - CheckMate is an application allowing you to perform quality checks on bilingual translated documents such as XLIFF, TMX, PO, TTX, etc.
  - Ratel is a simple editor for segmentation rules in SRX format.

For a list of changes since the previous release, please see the Changes Log document.

Note that parts of this project are still relatively new and still in development. Some of the classes, interfaces and internal workings presented here may change in the upcoming versions of the Okapi Framework.

`lib` | All the files needed to run the Okapi libraries and applications.
`help` | The help files.
`config` | Various default configuration files (e.g. segmentation rules, additional filter configurations, etc.)
`examples` | A few Java examples on how to use the library in your own programs. See the examples' readme file for details.
`dropins` | The directory where you can drop plug-ins.

The latest version of all documents and help is always available on-line, at the Okapi Framework Web site.

## Windows Platform

### Requirements

In order to run the Okapi applications on Windows you must have a running installation of Java 1.8 or later. Sun Java, or an OpenJDK VM is recommended.

### Installation

To install the Okapi applications on Windows (32- and 64-bit):

1. Download the ZIP file of the Windows distribution.
2. Unzip the file on any location where you have rights, for example `C:\Program Files\Okapi`.

To run Rainbow: simply double-click on the `rainbow.exe` file in the main folder.

You can also run the application with the following command line (assuming it has been unzipped in the recommended folder):

    C:\>javaw -jar C:\Program Files\Okapi\lib\rainbow.jar

To run Tikal: double-click on the `startTikalPrompt.bat` file. This will start a command prompt from where you can invoke Tikal from any directory. If you want to run Tikal at any time, from anywhere, you should add the directory where `tikal.bat` is located in the PATH of your system.

### Uninstallation

To uninstall:

1. Rainbow runs independently of Windows, so to uninstall it you can simply delete the folder where you have installed it. There is no Registry information to remove.
2. If you want you can also remove the file where the user preferences are saved. It is located in the Home folder of the user and called `.Rainbow`.

## Linux Platforms

#### Requirements

In order to run the Okapi applications on Linux you must have a running installation of Java 1.8 or later. Sun Java, or an OpenJDK VM is recommended.

### Installation

To install the Okapi applications on Linux (32- and 64-bit):

1. Download the ZIP file of the Linux distribution you need (there is one for 32-bit and one for 64-bit).
2. Extract the file on any location. Make sure to preserve the full paths when extracting.

To run, for example, Rainbow: simply double-click on the `rainbow.sh` file in the main directory.

You can also run the application from the command line (assuming Rainbow is installed in `\home\archie\okapi`):

    archie@archie:~>java -jar okapi/lib/rainbow.jar

### Uninstallation

To uninstall:

1. Delete the directory where the okapi application are installed.
2. If you want, you can also remove the files where the user preferences are saved. They are located in the Home folder of the user and called `.Rainbow` and `.Ratel`.

## MacOS Platform

### Requirements

In order to run the Okapi applications on MacOS you must have Java 1.8 installed. You can verify your Java version from the Terminal using `java -version`

### Installation

To install the Okapi applications on MacOS:

#### Installing release builds

Release builds are distributed as a signed DMG disk image.

1. Download the Okapi Applications disk image (.dmg) for MacOS. Note: Only 64-bit is supported.
2. Drag the "Okapi_[release]" directory into your `Applications` folder.
3. Upon initial launch you will receive a warning message indicating that the application was downloaded from the internet. Choose "Open" to contiune.

#### Installing snapshot builds

Snapshot builds are distributed as unsigned ZIP archives.

1. Download the ZIP file of the MacOS distribution. Note: Only a 64-bit distribution is available
2. Extract the ZIP file to any disk location. For example `~/Desktop/Okapi`.

Note: Because snapshot builds are unsigned, users on more recent versions of MacOS, particularly versions 10.12 (MacOS Sierra) and later, may have problems when running the applications. You work around this by relaxing the application security. From the Apple menu, choose 'System Preferences.../Security & Privacy/General'. You will see the application name that was prevented from launching. Click on the 'Open Anyway' button to launch the application.

For more information and help, please contact the Okapi Tools users group.

#### Running the Applications

To run, for example, Rainbow:

1. The main directory of the distribution contains a `Rainbow` application bundle (Rainbow.app): simply double-click on it.
2. If you're running the application for the first time since download, you will see a dialog warning you that Rainbow was downloaded from the internet. Choose 'Open' to confirm that you want to run it.

You can modify the shell file `rainbow.sh` that is in the `/Applications/Contents/MacOS` folder of the application bundle to fit your own parameters. In all cases you MUST specify the `-XstartOnFirstThread` option or the application may not work properly.

Tikal is a command-line tool and should be invoked from a Terminal window.

### Uninstallation

To uninstall:

1. Delete the entire directory where the Okapi applications were installed.
2. You can also remove user preferences created by Rainbow and Ratel with `'rm -rf ~/.Rainbow ~/.Ratel'`

## Support

If you have questions, suggestions or bug to report, you can do this different ways:

- Use the Send Feedback command in the Help menu of Rainbow.
- Read and post notes in the Okapi Tools users group (you need to be registered member to post, but not to read).
- Read and post issue reports on the project's issues list.