From dda0a83ee977f14aedb5a6345796ace15f9403d9 Mon Sep 17 00:00:00 2001
From: darkglade <35511291+darkglade@users.noreply.github.com>
Date: Mon, 15 Sep 2025 15:54:49 +1000
Subject: [PATCH] Update README.md

Updated README.md with instructions to successfully build on Bookworm.
---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index c4f4329..cbe156e 100644
--- a/README.md
+++ b/README.md
@@ -77,6 +77,10 @@ Now the final steps to get things up and running, all of this is done from a com
 * First run `sudo apt-get install libdrm-dev libegl1-mesa-dev libgles2-mesa-dev libgbm-dev` to install the DRM OpenGL/ES libraries, which are for some reason not included with the distro by default. These are necessary to link the graphics output library (raylib).
 * Then finally, run `make PLATFORM=PI3_BULLSEYE` for the emulator to compile successfully.
 
+**Important note:** If you are using **Raspberry Pi OS "Bookworm"**, the main graphics backend for the OS has changed from dispmanx to DRM, and you need to follow these steps instead of just running `make`:
+* First run `sudo apt-get install libdrm-dev libegl1-mesa-dev libgles2-mesa-dev libgbm-dev libraspberrypi-dev` to install the DRM OpenGL/ES libraries, which are for some reason not included with the distro by default. These are necessary to link the graphics output library (raylib), librasberrypi-dev is necessary to avoid the build failing due to `vc_tvservice.h` not being present.
+* Then finally, run `make PLATFORM=PI3_BULLSEYE` for the emulator to compile successfully.
+
 Next up, follow the steps for installing the FPGA bitstream update below. (Scroll down.)
 
 If you are running the PiStorm in an Amiga computer, you can start the emulator with a basic default Amiga config by typing `sudo ./emulator --config amiga.cfg`.