core functionality complete

README.md

@@ -1,6 +1,13 @@
 # Goon Plugin
 
-Chrome extension scaffold (Manifest V3).
+A Chrome extension (Manifest V3) that finds videos on the current page and displays them in a 2x2 grid.
+
+## Features
+
+- Click the extension icon → **"Find Videos"** to scan the current tab for all `<video>` elements
+- Videos are listed in the popup for reference (clickable links, "Copy All URLs" button)
+- Click **"Open Viewer"** to open a new window with videos in a 2x2 grid (autoplay muted)
+- Click **"Clear"** to reset the stored video list
 
 ## Getting started
 
@@ -29,8 +36,14 @@ package.json        — Dev tooling (Vite + Vitest + TS)
 vite.config.ts      — Build config
 src/
   background/       — Service worker (MV3 background)
-  popup/            — Popup UI (HTML + CSS + JS)
   content/          — Content script
+  viewer/           — Popup UI + video viewer
+    index.html      — Popup (Find Videos, Open Viewer buttons)
+    index.js        — Popup logic (scans current tab for videos)
+    index.css       — Popup styles
+    viewer.html     — Viewer page (2x2 video grid in new window)
+    viewer.js       — Viewer logic (renders video panels)
+    viewer.css      — Viewer grid styles
   icons/            — Extension icons (place .png files here)
 ```