OmegaT
installation and customization guide

[version 4.3.2 for macOS]

For a better view of this guide, make sure you click on the fullscreen button on the bottom right corner.

Are you running macOS?

You should use this guide if you want to use OmegaT in a computer running mac OS (version 10.12 and later).

If your computer runs Windows, please use our regular OmegaT installation and customization guide.

OmegaT

OmegaT is the open source computer-assisted translation tool (CAT tool) which we use to translate, reconcile, adapt, review and verify materials.

Also, you will need to customize your OmegaT installation with some additional files, in order to ensure an optimal interface and compatibility with the materials.

OmegaT version

• Install OmegaT from the link provided in this guide.
• Install OmegaT version 4.3.2
• Ignore prompt to update to latest version

• Do not download OmegaT from another link.
• Do not install any other version of OmegaT
• Do not update OmegaT to a newer version unless you are instructed to do so.

OmegaT version

Click on the box that corresponds to your current status:

You will:

• Uninstall (other versions)
• Install OmegaT 4.3.2
• Install customization

You will:

• Install OmegaT 4.3.2
• Install customization

If you have OmegaT installed but its version is
different from 4.3.2, please uninstall it.

To uninstall, just drag and drop to the Trash.

After having uninstalled that version, please proceed to step 1 to install version 4.3.2 of OmegaT.

Please click the link below to download the installer.

• standard version for macOS Notarized

☝

Please click the link below to download the installer.

• standard version for macOS Notarized

When you click on that link, a download will start.

During the installation:

• Choose English as the language of the installation and the interface

• In the License Agreement screen, please select
  “I accept the agreement” and click “Next”

• Tick option to create a desktop shortcut

• In all other dialogs, just press “Next” to use the default options until you reach “Ready to Install” screen.

• Then click on “Install”.

Steps:

• When you click the link, a download will start.

• When the download is complete, show the zip file in Finder.
  “I accept the agreement” and click “Next”

• Tick option to create a desktop shortcut

• In all other dialogs, just press “Next” to use the default options until you reach “Ready to Install” screen.

• Then click on “Install”.

click on the link

• When the download ends, Safari will unzip the file.​
  • If you use another browser, double-click the file to unzip it.

• A folder is created. Open it to see its contents.
  • It contains the OmegaT file.
• Drag it to the Applications folder. 

• OmegaT is now installed.
• Go to the Applications folder, and open OmegaT there.

• Your Mac will ask for confirmation that you want to open it. Press Open.
• OmegaT will now run.

• The OmegaT installation must be customized.
• The customization consists of adding some additional custom files to your OmegaT installation, which will allow you to work with projects provided to you.
• To do that, you must run the customization script.

It might be that you already have the script. 

---
-
-

Download the updateConfigBundle.groovy script from here.

☝

right click

Download Linked File

1

2

• Notice how the downloaded file has a .txt extension.
• Open the Downloads folder.
• Remove the .txt extension from the file.
• The file's extension should be .groovy.

In OmegaT, go to Tools > Scripting > File > Open script, and select the updateConfigBundle.groovy file from wherever you have saved it. Press Open.

Warning: Please do not update OmegaT to a newer version even if OmegaT prompts you to.

Press the Run button at the bottom left of the Scripting dialog.

The script will install all the necessary custom files in your OmegaT's user configuration folder.

It could be that the script doesn't have permissions to delete certain files in your C:\Program Files\OmegaT\plugins folder.

• You should now see all the script shortcuts under menu Tools > Scripting.
• You should also see menu items Import OMT package and Export OMT package under Project.

Under menu Tools > Scripting you should now see:

• All the script shortcuts

​

Under menu Project you should now see menu items:

• Unpack project from OMT file
• Pack project as OMT file
• Pack and delete project

If you need to insert non-breaking spaces or other special characters, you might  find our AutoHotKey script helpful.

1. Download and install AutoHotKey

2. Press Win+R on your keyboard and type shell:startup to open the Startup folder. Copy the path to that folder (e.g. C:\Users\<your-username>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup).

3. Right click on this link, choose “Save link as” and paste the path to the Startup folder, to download the script file in that folder.

4. Right click the script file (insert_unicode_char.ahk) in the Startup folder and choose Run script.

This script will be run automatically the next time your machine starts.