From cdc260b45c8149fcf68637855bbf2561911412b1 Mon Sep 17 00:00:00 2001 From: iTrooz Date: Mon, 19 Jan 2026 17:58:11 +0100 Subject: [PATCH] doc: add instructions to use ImHex on macOS without a GPU --- dist/compiling/macos.md | 2 ++ dist/compiling/macos_nogpu.md | 10 ++++++++++ 2 files changed, 12 insertions(+) create mode 100644 dist/compiling/macos_nogpu.md diff --git a/dist/compiling/macos.md b/dist/compiling/macos.md index e55e0b4e0..7fe416fb0 100644 --- a/dist/compiling/macos.md +++ b/dist/compiling/macos.md @@ -20,3 +20,5 @@ cmake -G "Ninja" \ .. ninja install ``` + +If your MacOS installation doesn't have graphic acceleration, you can check the [MacOS NoGPU guide](./macos_nogpu.md) \ No newline at end of file diff --git a/dist/compiling/macos_nogpu.md b/dist/compiling/macos_nogpu.md new file mode 100644 index 000000000..4199cb228 --- /dev/null +++ b/dist/compiling/macos_nogpu.md @@ -0,0 +1,10 @@ +### Compiling and running ImHex on macOS without a GPU + +In order to run ImHex on a macOS installation without a GPU, you need a custom build of GLFW. You can build it this way: + +Note: only tested on macOS x86 + +1. `git clone --depth 1 https://github.com/glfw/glfw` +2. `git apply {IMHEX_DIR}/dist/macOS/0001-glfw-SW.patch` (file is [here](../macOS/0001-glfw-SW.patch) in the ImHex repository. [Source](https://github.com/glfw/glfw/issues/2080).) +3. `cmake -G "Ninja" -DBUILD_SHARED_LIBS=ON ..` +4. `ninja install`, or `ninja` and figure out how to make ImHex detect the shared library