SGCCode · merval · May 31, 2026 · May 31, 2026 · May 31, 2026
diff --git a/README.md b/README.md
@@ -4,6 +4,20 @@
 
 A local web app for a Mac Studio that controls ProPresenter through the ProPresenter public REST API. It does **not** require Docker or npm packages. It now runs as a Flask application.
 
+## Screenshots
+
+### Main notes view
+
+![Main notes view showing slide thumbnails, selected slide notes, and navigation controls.](docs/screenshots/main-notes-view.png)
+
+### Library selector
+
+![Library selector showing available ProPresenter libraries.](docs/screenshots/library-selector.png)
+
+### Presentation selector
+
+![Presentation selector showing available presentations in the selected library.](docs/screenshots/presentation-selector.png)
+
 ## What it does
 
 - Shows a selector for presentations found in ProPresenter libraries.

diff --git a/docs/screenshots/README.md b/docs/screenshots/README.md
@@ -0,0 +1,11 @@
+# README screenshot assets
+
+Codex PR creation does not currently attach binary image files. Add the README
+screenshots manually at these paths after this text-only PR is applied:
+
+- `docs/screenshots/main-notes-view.png`
+- `docs/screenshots/library-selector.png`
+- `docs/screenshots/presentation-selector.png`
+
+The README already references these filenames, so uploading PNGs with these exact
+names will make the screenshots render without additional README edits.
diff --git a/docs/screenshots/library-selector.png b/docs/screenshots/library-selector.png
diff --git a/docs/screenshots/main-notes-view.png b/docs/screenshots/main-notes-view.png
diff --git a/docs/screenshots/presentation-selector.png b/docs/screenshots/presentation-selector.png