A collection of simple scripts (currently for macOS only) that install various tools and libraries useful for font development and hacking.

I plan to extend this from time to time.

— Adam Twardoch, 5 April 2017

1. Unpack the downloaded fontsurgery-tools-master.zip
2. Go to the macOS folder inside the unpacked fontsurgery-tools-master folder.
3. Double-click on install-macos.command.

The script may run for some 10-20 minutes as it downloads and installs various libraries, and you should be ready to hack your fonts.

At the end, it’ll open the websites where you can download and manually install further tools:

• Apple Font Tools for Xcode 8.2 or newer
• Adobe FDK for OpenType, AFDKO

• If you find that the installation does not work, please report an issue on Github.
• The scripts use Homebrew, a macOS management utility for command-line apps, which it installs when needed.
• Some libraries ("dependencies") are not usable directly, but they are installed because other tools or libraries need them.
• In the macOS folder, there is a upgrade-macos.command script which will install fresh versions of the various tools. You can run it from time to time.
• In the macOS-devel folder, there are install-macos-dev.command and upgrade-macos-dev.command scripts which will install cutting-edge versions of the same libraries as the regular script does (but those versions may fail installing or not work properly!) Note that the Python libraries will be installed in “development” mode, i.e. inside the macOS-devel/modules/src folder. So if you use this method, please place your unpacked fontsurgery-tools-master folder in some reasonable location, and possibly rename it (I recommend /Users/YOURUSERNAME/Developer/fontsurgery-tools).

• otfcc
• t1utils
• lcdf-typetools
• freetype
• icu
• fontconfig
• cairo
• fribidi
• harfbuzz
• ttfautohint

• The scripts install the newest Python 2.7.x and the newest Python 3.x, even though macOS already has them, but those come in an older version.
• Many of the Python libraries come with standalone command-line utilities.
• The Python libraries are installed for both Python 2.x and 3.x.
• The Python libraries are installed in the “user location” i.e. /Users/YOURUSERNAME/Library/Python. This makes it easy to see what’s going on.
• unicodedata2
• fontMath
• ufoLib
• fonttools
• compreffor
• cu2qu
• glyphsLib
• ufo2ft
• MutatorMath
• booleanOperations
• defcon
• fontmake
• feaPyFoFum
• ufo-extractor
• glyph-name-formatter
• designSpaceDocument
• pyparsing
• vttLib
• nototools
• font-line
• shapeops
• PyICU

• robofab
• fontParts
• ufo2fdk
• woffTools
• fontbakery

• qahirah
• python_freetype
• pybidi
• harfpy