From fdca1b598c3a22467109255e6709af45d800a55b Mon Sep 17 00:00:00 2001
From: tonym <anthonymoon61@gmail.com>
Date: Wed, 1 Oct 2025 00:24:43 -0500
Subject: [PATCH] Update README.md

---
 README.md | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 1c26db4..e75790e 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,36 @@
-# ha-gammy-bridge
+# Home Assistant ↔ Gammy Bridge
 
-Windows Gammy (flux alternative) <-> HA control
\ No newline at end of file
+A simple Python MQTT bridge to control [Gammy](https://github.com/Fushko/gammy) (open-source adaptive screen brightness/color temperature tool for Windows) from Home Assistant.
+
+This lets you:
+- Trigger **Ember mode** (~1900K, dim) when your house goes into sleep mode.
+- Trigger **Movie mode** (6500K, bright) when watching movies.
+- Toggle **Auto mode** (Gammy’s circadian cycle) for normal use.
+- Send custom temperature + brightness commands from HA.
+- Query the current state back into Home Assistant.
+
+---
+
+## 🚀 Features
+- MQTT topic subscription: `pc/gammy/mode`
+- Supported commands:
+  - `ember [snap|fast|slow]`
+  - `movie [snap|fast|slow]`
+  - `auto [snap|fast|slow]`
+  - `custom <temperature> <brightness> [snap|fast|slow]`
+- Publishes current state to: `pc/gammy/state`
+- Fade support (`snap=0s`, `fast=1s`, `slow=30s`)
+
+---
+
+## 📂 Files
+- `gammy_mqtt.py` → Main script.
+- `requirements.txt` → Python dependencies.
+
+---
+
+## ⚡ Installation
+1. Install [Python](https://www.python.org/downloads/) (Windows).
+2. Install requirements:
+   ```bash
+   pip install -r requirements.txt
\ No newline at end of file