Compiling FileZilla 3 under macOS

This documentation explains how to setup a build environment for FileZilla 3 and how to compile it under Mac OS X using Xcode. These directions have been tested under Tiger and Leopard on an Intel Mac. Other Mac OS versions may or may not work.

Setting up the build environment

This includes the compiler and the required tools to build FileZilla 3 and its dependencies.

Xcode

Download and install the latest Xcode package for your system. Xcode 2.5 is the right version for Tiger. As of this writing (February 21, 2009), Xcode 3.1.2 (24 Nov 2008) is the current version for Leopard.

If you are using Xcode 2.5, you will need to customize the install. Ensure all options under "Command Line Support" are checked. In Xcode 3.1.2, this is not necessary.

Building the Dependencies

FileZilla depends on the work of several open source projects. We must build them before we can build FileZilla.

The dependencies can take a long time to build. Instead of waiting for each project to build, you can start an additional Terminal Shell for each one and run them at the same time. However, you must have libgpg-error built before libgcrypt, and you must have libgcrypt built before GNU TLS.

If you have a multi-core machine, the build may go faster if you change "nice make" to "nice make -jN" where N equals the number of cores you have + 1 (e.g. dual-core: N = 3).

wxWidgets

Download wxWidgets. You will need version 2.8.9 or later. The current version for Mac is wxMac-2.8.10.tar.gz.

Start Terminal from the Applications/Utilities folder and enter the following commands:

cd /tmp
gzcat ~/Desktop/wxMac-2.8.10.tar.gz | tar x
mkdir build-wx
cd build-wx
../wxMac-2.8.10/configure --disable-shared --disable-compat26 --enable-unicode \
--prefix "$HOME"/filezilla/wxMac-2.8.10 && nice make && make install

GNU gettext

Download GNU gettext. The current version is gettext-0.17.tar.gz.

Start Terminal from the Applications/Utilities folder and enter the following commands:

cd /tmp
gzcat ~/Desktop/gettext-0.17.tar.gz | tar x
cd gettext-0.17
./configure --prefix "$HOME"/filezilla/gettext && nice make && make install

GNU libidn

Download GNU libidn. The current version is libidn-1.15.tar.gz.

Start Terminal from the Applications/Utilities folder and enter the following commands:

cd /tmp
gzcat ~/Desktop/libidn-1.15.tar.gz | tar x
cd libidn-1.15
./configure --disable-shared --prefix "$HOME"/filezilla/libidn && nice make && make install

libgpg-error

Download libgpg-error. The current version is libgpg-error-1.7.tar.bz2.

Start Terminal from the Applications/Utilities folder and enter the following commands:

cd /tmp
bzcat ~/Desktop/libgpg-error-1.7.tar.bz2 | tar x
cd libgpg-error-1.7
./configure --disable-shared --prefix "$HOME"/filezilla/libgpg-error && nice make && make install

libgcrypt

Download libgcrypt. The current version is libgcrypt-1.4.4.tar.bz2.

Start Terminal from the Applications/Utilities folder and enter the following commands:

cd /tmp
bzcat ~/Desktop/libgcrypt-1.4.4.tar.bz2 | tar x
cd libgcrypt-1.4.4
./configure --disable-shared --prefix "$HOME"/filezilla/libgcrypt \
--with-gpg-error-prefix="$HOME"/filezilla/libgpg-error && nice make && make install

GNU TLS

Download GNU TLS. The current version is gnutls-2.6.6.tar.bz2

You also need to download gnutls.patch.

Start Terminal from the Applications/Utilities folder and enter the following commands:

cd /tmp
bzcat ~/Desktop/gnutls-2.6.6.tar.bz2 | tar x
cd gnutls-2.6.6
patch < ~/Desktop/gnutls.patch
./configure --disable-shared --prefix "$HOME"/filezilla/gnutls \
--with-libgcrypt-prefix="$HOME"/filezilla/libgcrypt && nice make && make install

Now we need to fix a problem with libgnutls-config because it forgets it needs zlib.

Open the file "$HOME"/filezilla/gnutls/bin/libgnutls-config in TextEdit (or some other text editor). Look for a line near the top that resembles:

gnutls_libs="-L${exec_prefix}/lib -lgnutls  -L/Users/x/filezilla/gnutls/lib -lgcrypt -lgpg-error  "

Add -lz at the end so that it looks more like:

gnutls_libs="-L${exec_prefix}/lib -lgnutls  -L/Users/x/filezilla/gnutls/lib -lgcrypt -lgpg-error -lz "

Please note the space between -lz and the closing quote; it must be present.

Building FileZilla 3

Download the FileZilla source. The current version is FileZilla_3.2.5_src.tar.bz2.

Start Terminal from the Applications/Utilities folder and enter the following commands:

cd /tmp
bzcat ~/Desktop/FileZilla_3.2.5_src.tar.bz2 | tar x
cd filezilla-3.2.5
export PATH="$HOME"/filezilla/wxMac-2.8.10/bin:"$HOME"/filezilla/gettext/bin:$PATH
./configure CPPFLAGS="-I\"$HOME\"/filezilla/libidn/include" \
--with-idn-lib="$HOME"/filezilla/libidn/lib/libidn.a \
--with-libgnutls-prefix="$HOME"/filezilla/gnutls --disable-shared && nice make
cd FileZilla.app/Contents/MacOS
strip filezilla fzputtygen fzsftp
cd - && mv FileZilla.app ~/Desktop

If you get an error after "nice make", try this:

rm -rf FileZilla.app && nice make

Troubleshooting

If you run into problems, please make sure you've followed each step exactly how it is explained and that you haven't missed any steps along the way. Feel free to ask questions on the FileZilla forums.