Files
ha-gammy-bridge/README.md
2025-10-01 00:24:43 -05:00

36 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Home Assistant ↔ Gammy Bridge
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** (Gammys 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