fluxengine-gui (gui2 / ImHex) fails to build with Homebrew mbedTLS

[ndrpri]

I am building FluxEngine on macOS (Sequoia) using Apple Command Line Tools and Homebrew.

The command-line client builds and works correctly, but the GUI (gui2, ImHex-based) consistently fails to compile.

The build stops while compiling ImHex with the following error:

error: use of undeclared identifier 'MBEDTLS_INTERNAL_VALIDATE_RET'

This happens in dep/imhex/lib/libimhex/source/helpers/crypto.cpp and is reproducible with both Homebrew mbedtls 3.x and mbedtls@2 (2.28.10).

It appears that ImHex relies on internal mbedTLS macros which are not enabled in Homebrew builds of mbedTLS, making gui2 unbuildable on macOS using standard Homebrew dependencies. The failure does not seem to be related to the SDK, compiler version, or include paths.

Disabling gui2 in build.py allows the FluxEngine CLI to build successfully, but at the moment I do not see a way to build fluxengine-gui on macOS without patching ImHex or using a custom-built mbedTLS.

Is this a known limitation of gui2 / ImHex on macOS, and is there a recommended or supported way to build the GUI on this platform?

Environment:

• macOS Sequoia
• Apple Command Line Tools (no full Xcode)
• clang (Apple / Homebrew LLVM)
• Homebrew dependencies
• mbedtls 3.x (default) -> incompatible
• mbedtls 2.28.x (mbedtls@2) -> still fails

Thank you for your work on FluxEngine.

[davidgiven]

It does build on OSX, both Intel and ARM, and I have the CI runs to prove it: https://github.com/davidgiven/fluxengine/actions/runs/20608428970

The scripts used for the build are here:

fluxengine/.github/workflows/release.yml

Line 104 in 6dde81b

brew install sqlite pkg-config libusb protobuf wxwidgets fmt make coreutils dylibbundler libjpeg libmagic nlohmann-json cli11 boost glfw3 md4c ninja python freetype2 mbedtls@3 lunasvg

(Although I don't know which version Sequoia is and how it compares to whichever OSX versions the Github CI systems use, whch could be the cause of the issue.)

[ndrpri]

Hi David,

thank you for pointing me to the release.yml workflow — that was the key.

Using that file as a reference, I wrote a small build script (attached below) and with it I was finally able to compile successfully on my system.

I’m on macOS 15 (Sequoia), following the same steps as in the workflow resolved the issue for me.

Thanks again for the help and for maintaining the project.

compile-fluxengine-macos15.sh

Piero