doc: add instructions to use ImHex on macOS without a GPU

This commit is contained in:
iTrooz
2026-01-19 17:58:11 +01:00
parent 0e41813cfc
commit cdc260b45c
2 changed files with 12 additions and 0 deletions

View File

@@ -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)

10
dist/compiling/macos_nogpu.md vendored Normal file
View File

@@ -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