Skip to content

OmegaT 5.7.3 setup guide for macOS

This document guides you through the process of installing OmegaT 5.7.3 in your machine. This is a custom version prepared by cApStAn which includes several enhancements and bug fixes not available in the official release.

Are you a Windows user?

Do not use this guide if you are a Windows user. In that case, please refer to the guide to install on Windows.

Installation

  1. Click on the button below to download OmegaT 5.7.3.

    Download OmegaT 5.7.3

  2. If you're using Safari, then the file will be unzipped automatically when the download ends.​ If you use another browser, double-click the file when the download ends to unzip it.

  3. A folder is created, open it to see its contents. You'll see that it contains the OmegaT.app file.

  4. Drag the OmegaT.app file to the Applications folder.

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

  6. Your Mac might ask for confirmation that you want to open it. If that's the case, please press Open. OmegaT will now run.

    On newer versions of macOS, you may need to control-click (right click) on OmegaT and select Open. If it doesn't open, you might need to permit OmegaT to run by clicking on Open Anyway next to OmegaT in System Settings > Privacy and Security > Security.

    Self-signing in macOS Sequoia 15.1

    As of macOS Sequoia 15.1, it may be impossible to run OmegaT even with right clicking on the app and selecting Open. This might change in the future, but currently to work around that problem one needs to self-sign the downloaded application. Here are the steps to do that:

    • Open Keychain Access on your Mac. If you can't find Keychain Access, navigate to /System/Library/CoreServices/Applications in Finder, and open Keychain Access.app.

    • From the Keychain Access menu, go to Certificate Assistant > Create a Certificate.

    • Name your certificate (e.g., My App Signing Cert), set the Identity Type to Self-Signed Root, and the Certificate Type to Code Signing.

    • Save the certificate in the login keychain.

    • Run the codesign command in your Terminal to sign OmegaT.app with the certificate you created. The basic command looks like this: 

      codesign --deep --force --verify --verbose --sign "My App Signing Cert" /Applications/OmegaT.app
      If you gave your certificate a different name and/or copied OmegaT.app to a different location, change the above command accordingly.

Setup checks

If you want to run a post-installation check to confirm that you have the correct version, you can check that in Help > About > Copy Support Info. You should see:

Version: OmegaT-5.7.3_0_57b1bb571
Platform: Mac OS X 15.1
Java: 11.0.23 x86_64

Configuration

The OmegaT installation must be configured with some custom files. Please follow the next steps to install or update your configuration.

  1. Run OmegaT and go to Tools > Scripting to open your scripting console, Check whether you have a script called "Update Customisation Bundle"

  2. If the script "Update Customisation Bundle" is there, please click on it to select it and press the Run button (at the bottom left) to run it. The script will run to update your config files and will quit OmegaT.

If you don't have the script, here's a fallback plan

If the script is not there, you may download it yourself. See next steps for how to do that.

  1. Right-click on the button below and select "Save Link As" to download the configuration script (e.g. to your Desktop)

    Download UpdateConfigBundle.groovy

  2. In OmegaT, follow these steps to run the configuration script you have downloaded:

    • Tools > Scripting > File > Open script
    • browse to your Desktop (or the folder where you have saved the script) and select the groovy file
    • press the Open button to open the script file and press Run button (on the bottom left)

    The script will install the necessary config files, and after that it will quit OmegaT.

You're done now. You can start using OmegaT.

Your user Name/ID

When opening OmegaT for the first time, please update your Name/ID. To do that click on Options > Preferences > Team.

The Name/ID box might already contain your username. If that's the case, it's fine like that. Otherwise, if the box is empty or ther's some detail that doesn't identify you (e.g. USER), please enter your name or a nickname that identifies you more or less uniquely and that we can associate with you.

If you have been asked to use "VER" in a specific project and you only work as a verifier, you can append your name or initials to that (e.g. VER_msoutopico, VER_manuel, etc).

Then press OK.