ha-gammy-bridge/README.md

Home Assistant ↔ Gammy Bridge

A simple Python MQTT bridge to control 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 (Windows).
2. Install requirements:

   pip install -r requirements.txt