When compiled under the MSYS2 environment, the executible that is
produced expects the SDL2 library to be available at runtime. When
running outside MSYS2, that may not be the case, and the emulator may
crash on startup with a message about missing SDL2.dll, or sometimes
without a message at all.
This patch adds some guidance for this scenario by guiding the reader
to download the precompiled SDL binaries for Windows and make them
available for the emulator's use.
---
README.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/README.md b/README.md
index 0c7e24d..628859c 100644
--- a/README.md
+++ b/README.md
@@ -54,6 +54,8 @@ cd uxn
./build.sh
```
+To run the emulator _outside_ of the MSYS2 environment, download the [SDL runtime binary for Windows](https://libsdl.org/download-2.0.php) and place the `SDL2.dll` file in the same directory as the emulator (`bin/`).
+
## Getting Started
### Emulator
--
2.34.0.windows.1