Build from source

Use the source tree or the exact versioned source archive for the release you want to build. Do not mix generated/native files from different q4t versions.

Toolchain

Go 1.27.x is the primary development and build toolchain. The project also keeps source compatibility with Go 1.26.x where the current release policy requires it.

Linux

For ordinary Linux builds, install Go 1.27.x and the normal platform build tools required by your distribution. q4t is built from the extracted source tree.

go build -o q4t ./cmd/q4t
go build -o q4t-web ./cmd/q4t-web

This website distributes Linux amd64 builds only. Use the build instructions supplied with the corresponding source archive for release-specific requirements.

Windows amd64

Install Go 1.27.x and MSYS2. For the native Windows Bluetooth component, use the CLANG64 environment with Clang, CMake, Ninja and C++/WinRT available.

pacman -S --needed \
    mingw-w64-clang-x86_64-clang \
    mingw-w64-clang-x86_64-cmake \
    mingw-w64-clang-x86_64-ninja \
    mingw-w64-clang-x86_64-cppwinrt

Run the release-specific build instructions from the source tree after the native prerequisites are installed.

Cross-compilation

For Windows amd64 cross-builds from Linux, the native Bluetooth component requires a suitable MinGW/LLVM-MinGW C/C++ toolchain with C++/WinRT support.

This page is the stable location for build prerequisites and per-platform build instructions; it can be expanded as the release matrix grows.