Add dynamic Firefox accent color extension

1 files changed, 40 insertions, 0 deletions

diff --git a/browsers/README.md b/browsers/README.md
new file mode 100644
index 0000000..96ddfc3
--- /dev/null
+++ b/browsers/README.md
@@ -0,0 +1,40 @@
+# Browser Accent Color Experiments
+
+This directory contains experiments for applying the dynamic accent color
+provided by `core/accent.h` to web browsers.
+
+## Ungoogled-Chromium
+
+Ungoogled Chromium exposes limited theming hooks and does not support
+changing its UI colors at runtime. Applying a dynamic accent color would
+require maintaining a custom patch set or an extension that continually
+re-themes the browser, which is outside the scope of this repository.
+
+## Firefox
+
+Firefox can be themed programmatically. The files here demonstrate two
+approaches:
+
+1. `firefox/update-userchrome.sh` writes a minimal `userChrome.css` using the
+   current accent color. Run it whenever the accent color changes.
+2. `firefox/extension/` contains a small WebExtension and native messaging host
+   that continuously updates a `--accent-color` CSS variable across all pages.
+
+To use the extension:
+
+1. Build the helper program:
+
+   ```sh
+   ./build.sh
+   ```
+
+2. Register the native messaging host:
+
+   ```sh
+   firefox/install-native-host.sh
+   ```
+
+3. Load `firefox/extension` as a temporary extension from `about:debugging`.
+
+These scripts are meant as a starting point for proper browser ricing and can
+be adapted to other workflows.