Apertium on Mac OS X

From Apertium
Jump to navigation Jump to search

En français

Use either Homebrew or Macports.

Basic Installation Using Homebrew[edit]

  1. Make sure Homebrew is installed
    1. If not, you can get it from https://brew.sh
  2. Install all dependencies by running the following in the terminal:
    brew install gperftools help2man pcre icu4c perl518 gawk autoconf automake pkg-config cmake wget gcc
    Note that if you have a slightly older version of macOS, you'll want to use apple-gcc42 instead of gcc
  3.  curl https://apertium.projectjj.com/osx/install-nightly.sh | sudo zsh
    Then type your password
    Note that you'll probably need to type your sudo password, and the prompt may be covered up by the curl display.
    Note also that if you have an old version of macOS, you may need bash instead of zsh

Basic Installation Using Macports[edit]

  1. Make sure XCode is installed
    1. If not, download it from http://developer.apple.com/xcode/
    2. Be sure to include Command Line Tools
    3. (http://railsapps.github.io/xcode-command-line-tools.html is nice guide if you get stuck here)
  2. Make sure Macports is installed
    1. If not, download it from http://www.macports.org/install.php
  3. Install all dependencies by running the following in the terminal:
    sudo port install autoconf automake expat flex \
    gettext gperf help2man libiconv libtool \
    libxml2 libxslt m4 ncurses p5-locale-gettext \
    pcre perl5 pkgconfig zlib gawk icu cmake boost gperftools
  4.  curl https://apertium.projectjj.com/osx/install-nightly.sh | sudo bash

Language data packages[edit]

If you've installed tools with install-nightly.sh, you can install language data with https://apertium.projectjj.com/osx/install-nightly-data.sh .

First, download the script and make it executable

   curl https://apertium.projectjj.com/osx/install-nightly-data.sh
   chmod +x install-nightly-data.sh

If the curl command does not deliver the install-nightly-data.sh, just download it via your browser (click the link). Remeember to remove the .txt part the browser added to the filename. then run the chmod +x command as shown.

Then to install a language pair:

   ./install-nightly-data.sh apertium-eng-deu

and try it out:

   echo 'Hello world' | apertium eng-deu

This language date is compiled nightly from git versions, but you'll have to re-run the script to get new versions.

The script can only fetch what's there. You can see available language pairs / packages at:

Remember, you need to install tools first (see above sections).


There is also a script for release versions of pairs, https://apertium.projectjj.com/osx/install-release-data.sh , which can fetch the pairs listed at:

Compiling from Source[edit]

Are you sure this is the part you want?
If you're here because one of the previous sections didn't work, log on to IRC and describe what went wrong.

You probably want Prerequisites for Mac OS X which gives you all the dev tools you might want – this page has more in-depth documentation on compiling the core/dev tools from source.


There are two main options for installing, "system" and "local":

  • Apertium on Mac OS X (System) — The fastest and easiest way is to install in your main system path (that is in /usr/local), choose this if you have root access on your system.
  • Apertium on Mac OS X (Local) — The second way is to install locally (that is in your home directory, e.g. /Users/myname/Local), this is more contained but slower and more difficult, choose this if you don't have root, or want to make the Apertium installation completely separated from your main system. This can be better for developers.

If you do not have any experience compiling source code, you can also follow the more user-friendly Mac guide Apertium on Mac OS X (User), which walks you through every step.