You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

93 lines
3.1 KiB

Instructions for building on Windows.
Fuller instructions that include
* Portable Settings
* Building an Installer
can be found on our wiki at
1. MSVC 2017: Download and install Microsoft Visual Studio 2017
2. Git: Download and install Git, for example by installing:
Git for Windows:
and optionally GitExtensions:
download and run the .msi installer. GitExtensions has a GUI interface, includes Git for
Windows and has a Git bash command line in the bottom panel of the screen.
3. Python
We currently depend on Python 2.7.18 during the build. We are working on a switch to a Python 3.
At the time of writing, Python 2.7.18 must be on your path.
4. wxWidgets:
1) Clone wxWidgets and checkout 3.1.3 from the Audacity fork of the
wxWidgets project:
for example, in the git-bash command line
mkdir ./wxWidgets
cd ./wxWidgets
git clone --recurse-submodules
IF you forgot the --recurse-submodules, you can correct that later by:
git submodule update --init
2) Follow instructions for building at
We (currently) build the 32 bit DLL version,
and Audacity is built 32 bit too.
Set WXWIN environment variable to the appropriate directory where you installed
wxWidgets. This will tell CMake where to find wxWidgets later.
To set WXWIN, click on Settings (the cogwheel icon from the start menu)
Then in the 'find settings' search box type 'env'.
Choose 'Edit the system environment variables'
Then the 'Environment Variables' button
Then in system variables, for variable and value, add (for example)
WXWIN C:\wxWidgets-3.1.3
You will be building a dll version with MSVC2017 IDE, so...
In MSVC 2017 open wx_vc15.sln, and select dll, release.
Then build.
3) Having got this far, it is well worth trying out building some wxWidgets
examples to confirm that building has worked OK
5. Audacity
1) Clone Audacity from the Audacity GitHub project.
for example, in the git-bash command line
mkdir ./audacity
cd ./audacity
git clone
Audacity itself does not use/need git submodules.
2) Open the CMake GUI.
Set the 'Where is the source code' location to where your copy of the git repo is.
Set the 'Where to build the binaries' to where you want the results.
Click on configure.
(notice where it found / did not find wxWidgets if it did not find wxwidgets check
that you set WXWIN coreectly )
3) Click on Generate.
4) Click on Open Project.
From here on you should be able to use the project.
Choose Release or Debug.
Click compile.