Compilation guide

Prerequisites

In order to compile Magpie, you need to first install:

1. The latest version of Visual Studio 2026. You need to install both "Desktop development with C++" and "Universal Windows Platform development" workloads and Windows SDK build 26100 or newer.

2. Python 3.14+

3. Conan

   pip install conan

   Make sure that the above dependencies have been added to the system path, and use the following commands to check:

   python --version
   conan --version

Compiling

1. Clone the repo

   git clone https://github.com/Blinue/Magpie

2. Open the Magpie.slnx in the root directory and build the solution.

Enabling Touch Support

To enable touch input support, TouchHelper.exe needs to be signed. While signing is automatically done in the CI pipeline, you can also manually sign it. Follow these steps:

1. Create a self-signed certificate and export it as a pfx file.
2. Replace the CERT_FINGERPRINT constant in src/Magpie/TouchHelper.cpp with the SHA-1 hash (i.e., fingerprint) of your certificate.
3. Run the following command in the root directory of the repository:

python scripts/publish.py --pfx-path=<pfx path> --pfx-password=<pfx password>

This will compile Magpie and sign TouchHelper.exe. The compiled files will be located in publish\x64.