How To Use the Windows SDK

  1. Download and install the following:
  1. Extract the Shotcut SDK .zip file to a new folder in C:\ named “Projects” (C:\Projects).
  2. In Qt Creator open C:\Projects\Shotcut\src\shotcut\CMakeLists.txt.
  3. In the Configure Project screen, select your previously configured Kit and click Configure Project: Configure Project

  4. Click Projects in the navigation bar on the left side of the Qt Creator window.
    • In the left column of the Shotcut project configuration click Build to show the Build Settings:
    • In Build Environment add environment variable PKG_CONFIG_PATH and set it to C:\Projects\Shotcut\lib\pkgconfig.
    • Prepend msys2 binary folders to environment variable Path: C:\msys64\usr\local\bin;C:\msys64\mingw64\bin;
    • In CMake > Current Configuration find CMAKE INSTALL_PREFIX and change its value to C:\Projects\Shotcut and click Run CMake.
  5. In the left column of the Shotcut project configuration click Run to show the Run Settings: Run Settings
  • In Run click Add… > Custom Executable;
    in Executable: enter “C:\Projects\Shotcut\shotcut.exe”: Run Settings
  1. After clicking Run (the green play button in bottom left of Qt Creator), you can confirm the newly built executable is the one that is running from the Help > About Shotcut… dialog: the version will be “adhoc”.

Final Project

Project Final

Rebuilding Dependencies

The section above just gets you a working environment for the Shotcut code, but not any of its dependencies. Some of the dependencies included in the SDK with source code can be opened and used within Qt Creator - e.g., frei0r. Instructions for that are not yet included. In other cases you can use the Git Bash shell environment. Upon opening a Git Bash shell, enter (or add to ~/.profile and restart the shell):

export PATH="/c/Qt/x86_64-5.4.0-release-posix-seh-rt_v5-rev0/mingw64/bin:$PATH"
export QTDIR="c:/Qt/qt-5.9.7-x64-mingw540-seh"
export CC=gcc
export CXX=g++
export PKG_CONFIG_PATH="c:/Projects/Shotcut/lib/pkgconfig"
export CFLAGS="-Ic:/Projects/Shotcut/include -DHAVE_STRUCT_TIMESPEC"
export LDFLAGS="-Lc:/Projects/Shotcut/lib -Lc:/Projects/Shotcut"
alias make=mingw32-make

For a project’s configure step, often you can supply the prefix as /c/Projects/Shotcut and make install will work as expected. However, sometimes you need to copy DLLs from bin/ or lib/ into /c/Projects/Shotcut where shotcut.exe resides.

When working with git repos from the SDK on Windows, it may helpful to issue git config core.fileMode false to prevent unchanged files from appearing in git status and git diff.

Command Line Debugging

When using gdb at the command line to debug, using Ctrl+C to break execution will also exit the debugger. There is a program called breakgdb.exe (source) that can be used to break execution.


Recent Posts


Shotcut is a free, open source, cross-platform video editor for Windows, Mac and Linux. Major features include support for a wide range of formats; no import required meaning native timeline editing; Blackmagic Design support for input and preview monitoring; and resolution support to 4k.

Social Links

Copyright © 2011-2024 by Meltytech, LLC
Shotcut is a trademark of Meltytech, LLC.