This version (14 Jul 2020 17:15) was approved by Adrian Suciu.The Previously approved version (14 Jul 2020 14:42) is available.Diff

Building Scopy on Windows

Building Scopy on Windows is pretty error prone. Do not build Scopy on Windows unless absolutely necessary.

You can get the latest Windows release here:

Installing MSYS2

Download MSYS2 from here: MSYS2 Download
Follow the instructions on the page linked above to install it, and update it.
!!!Open the MINGW64 shell of MSYS. Other terminals will not work! Make sure all packages are up to date.


pacman -Syu

When it's done, you need to install a couple of packages (64-bit or 32-bit) to be able to be build Scopy:


pacman -Syu --needed git tar cmake mingw-w64-x86_64-cmake mingw-w64-x86_64-make mingw-w64-x86_64-gcc mingw-w64-x86_64-ninja mingw-w64-x86_64-gdb


pacman -Syu --needed git tar cmake mingw-w64-i686-cmake mingw-w64-i686-make mingw-w64-i686-gcc mingw-w64-i686-ninja mingw-w64-i686-gdb

Building Scopy

First, make sure you are running the 64-bit shell (MingW64) of MSYS2. It won't work in any other shell.

Cloning the repository

cd ~
git clone
This will fetch the latest sources from GitHub to a “scopy” directory.
First, let's create a build folder so that we don't pollute the sources with generated files:
mkdir ~/scopy/build
cd ~/scopy/build

Installing the Dependencies

Scopy has many dependencies and various errors can occur when installing these manually.
To simplify things, we created two shell scripts: one to configure MSYS environment variables and one to download and install all the required components.
Run these as shown below.

source ../CI/appveyor/
The first script configures the environment variables(MingW version, system architecture,compliers, CMake options).
The second, which installs the dependencies, is similar to previous build guide:first, it installs the dependencies, that can be handled by pacman. After that, an archive of precompiled libraries(gnuradio, libsigrok, etc) is downloaded. Its contents are then installed.

If you are using 32-bit Windows, before you run the scripts, you need to edit the set_build_env_msys script to comply with your system architecture.

export ARCH=i686
export MINGW_VERSION=mingw32

The file is should be located at C:\msys64\home\user\scopy\CI\appveyor.
Return to the MINGW64 shell prompt and run the scripts as indicated above.
Then, let's configure the build:


If everything goes well, it should say “Configuring done” and “Generating done”.
To build the project:

This can take as long as 10 minutes or more, depending on your CPU.

Running Scopy

To run Scopy, it is required to first set a few environment variables.
To do that, click on the Start menu, search for 'environment'.
The option 'Edit environment variables for your account' should appear; click on it.

The following dialog will open:

You will need to create two environment variables: “PATH” and “SCOPY_PYTHONPATH”. First, let's add “PATH”:

  • Click on “New…”
  • In “Variable name:”, write PATH
  • In “Variable value:” write %PATH%;C:\msys64\mingw64\bin
  • Then click OK.

Finally, add the “SCOPY_PYTHONPATH” variable:

  • Click on “New…”
  • In “Variable name:”, write SCOPY_PYTHONPATH
  • In “Variable value:” write C:\msys64\mingw64\lib\python3.7;C:\msys64\mingw64\lib\python3.7\plat-win;C:\msys64\mingw64\lib\python3.7\lib-dynload;C:\msys64\mingw64\lib\python3.7\site-packages
  • Then click OK.

Once those steps are done, the Scopy you built should run. With the file explorer, navigate to:


Double-click on scopy.exe.

Set up QtCreator

To avoid using the MSYS terminal to rebuild the app, you can use QtCreator to build it.
First, you need to install it using an offline or an online installer from the official Qt Downloads page. In the installer,select only the QtCreator option. This way, only the creator will be installed. Other Qt Libraries needed we be uses from the MSYS folder. After you installed it, open it.

For the build to work, you need to configure a build kit to have the same compilers, Qt version and debugger you used when building from the MSYS terminal. To do this, open the configuration menu, as shown below and go to Kits.

In the compiler tab, configure the C and C++ compilers. They might not be automatically detected; you might need to add them manually. Make sure that you select the correct compilers.
For C, this would be C:\msys64\mingw64\bin\x86_64-w64-mingw32-gcc.exe .
For C++: C:\msys64\mingw64\bin\x86_64-w64-mingw32-g++.exe .

Do the same for:
Qt Versions (C:\msys64\mingw64\bin\qmake.exe)
Debuggers (C:\msys64\mingw64\bin\gdb.exe)
Make sure you have added each component from your msys/mingw64 folder.
Then go to Kits, click Add and configure your build kit with the options you just added.

Select Ninja as the Cmake generator.
Name your kit, then select the tools from the msys folder, as indicated above, then click OK.

Now, to open Scopy as a project, click Open file or Project and open CMakeLists.txt.

Select the new build kit and click Configure Project.

Now just click Build and Run and QtCreator will handle the rest.

In case Cmake will throw an error when you first try to build the project, you will need to edit the Cmake Configuration.
To do this go to Tools>Options again and select your kit. The last option in the configuration list is the CMakeConfiguration.
Click Change and add the path to your Cmake as indicated below. At the third line, add a “;” and then the full path (for example: C:\msys64\mingw64\lib\cmake).

Return to Scopy Main Page

university/tools/m2k/scopy/build-windows.txt · Last modified: 14 Jul 2020 17:15 by Adrian Suciu