diff --git a/README.md b/README.md
index 404e4d4..1e5b186 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
+Update
+======
+
+This repo is ancient and deprecated.
+
+It largely contains code using proprietary APIs to interface
+to the VideoCore firmware. We have since move to standard linux APIs.
+
+V4L2, DRM/KMS and Mesa are the APIs you should be using.
+
+The few useful tools from here (dtoverlay, dtmerge, vcmailbox, vcgencmd)
+have been moved to the raspberrypi/utils repo.
+
+Code from here is no longer installed on latest RPiOS Bookworm images.
+
+If you are using code from here you should rethink your solution.
+
+Consider this repo closed.
+
+========================
+
 This repository contains the source code for the ARM side libraries used on Raspberry Pi.
 These typically are installed in /opt/vc/lib and includes source for the ARM side code to interface to:
 EGL, mmal, GLESv2, vcos, openmaxil, vchiq_arm, bcm_host, WFC, OpenVG.