Skip to content

Build wxWidgets from sources


CodeLite uses MSYS2 for installing compiler and other tools:

  • Prepare a working terminal with all the tools required as described here
  • Open MSYS2 terminal, and clone wxWidgets sources:
git clone
cd wxWidgets
git submodule update --init
  • For a Release build of wxWidgets, run this:
mkdir build-release
cd build-release
cmake .. -G"MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release                 \
         -DwxBUILD_DEBUG_LEVEL=0                                        \
mingw32-make -j$(nproc)
  • For a Debug build of wxWidgets, run this:
mkdir build-debug
cd build-debug
cmake .. -G"MinGW Makefiles" -DCMAKE_BUILD_TYPE=Debug -DwxBUILD_DEBUG_LEVEL=1
mingw32-make -j$(nproc)


To build wxWidgets on you computer you will need these packages:

  • The gtk development package: for GTK+2 it's often called libgtk2.0-dev or similar; for GTK3, libgtk-3-dev
  • pkg-config (which usually comes with the gtk dev package)
  • The build-essential package (or the relevant bit of it: g++, make etc)
  • git
  • cmake

Use the following command to install the prerequisites for Ubuntu 18.04:

sudo apt-get install libgtk-3-dev \
                     pkg-config \
                     build-essential \
                     git \
                     cmake \
                     libsqlite3-dev \
                     libssh-dev \
                     libedit-dev \
                     libhunspell-dev \
                     clang-format-12 \


If your distro provides a newer version of clang-format, install it. The higher, the better

mkdir -p $HOME/devl
cd $HOME/devl

# download wxWidgets 3.2.0 & extract it
bzip2 -d wxWidgets-3.2.0.tar.bz2
tar xvf wxWidgets-3.2.0.tar.bz2

# build and install it
cd wxWidgets-3.2.0
mkdir -p build-release
cd build-release
../configure --disable-debug_flag --with-gtk=3 --enable-stl
make -j$(nproc) && sudo make install



  • Install Homebrew
  • Install cmake
  • Install git
  • Install latest Xcode from Apple
  • Install the Command Line Tools (open XcodePreferencesDownloads and install the command line tools). This will place clang/clang++ in the default locations /usr/bin
  • Download wxWidgets sources

Build wxWidgets

mkdir $HOME/src
cd $HOME/src
git clone
cd $HOME/src/wxWidgets
git submodule init
git submodule update
mkdir build-release
cd build-release
../configure --enable-shared --enable-monolithic --with-osx_cocoa CXX='clang++ -std=c++17 -stdlib=libc++ -I../src/tiff/libtiff' CC=clang --disable-debug --disable-mediactrl --enable-stl
make -j$(sysctl -n hw.physicalcpu)
sudo make install
Back to top