From 0f5048b5c034b4eaa599bb955857e47fdef08cfa Mon Sep 17 00:00:00 2001
From: John Ogle <john@ogle.fyi>
Date: Sat, 25 Oct 2025 21:41:26 -0700
Subject: [PATCH] Add README

---
 README.md | 160 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 160 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..37a4e39
--- /dev/null
+++ b/README.md
@@ -0,0 +1,160 @@
+# Home Assistant Blueprints
+
+## Multi-Press Action Blueprint
+
+Trigger different actions based on how many times an entity changes state rapidly. Perfect for light switches, buttons, or any entity where you want single, double, triple, or quad-press actions.
+
+### Import URL
+```
+https://git.johnogle.info/johno/home-assistant-blueprints/raw/branch/main/multi_press_action.yaml
+```
+
+### Installation
+
+**Method 1: Import via UI**
+1. Go to Settings → Automations & Scenes → Blueprints
+2. Click "Import Blueprint" (blue button, bottom right)
+3. Paste the import URL above
+4. Click "Preview" then "Import"
+
+**Method 2: Manual Installation**
+1. Download the blueprint file
+2. Place it in `/config/blueprints/automation/multi_press_action.yaml`
+3. Restart Home Assistant or reload automations
+
+### Features
+
+- **Configurable time window**: Set how quickly presses must occur (default 1.5s)
+- **Immediate or delayed single-press**: Choose whether single press acts instantly or waits
+- **Up to 4 press levels**: Single, double, triple, and quad press actions
+- **Complex action support**: Each action can include conditions, scenes, scripts, and more
+
+### Configuration Options
+
+| Input | Description | Default |
+|-------|-------------|---------|
+| **Trigger Entity** | The entity to monitor for state changes | Required |
+| **Time Window** | Maximum time between presses (seconds) | 1.5 |
+| **Execute Single Press Immediately** | Run single press action without waiting | Yes |
+| **Single Press Action** | Action(s) to run on single press | None |
+| **Double Press Action** | Action(s) to run on double press | None |
+| **Triple Press Action** | Action(s) to run on triple press | None |
+| **Quad Press Action** | Action(s) to run on quad press (4 times) | None |
+
+### Usage Examples
+
+#### Example 1: Light Switch with Scene Control
+
+**Use Case**: Normal switch operation, but double-press for bright scene
+
+**Configuration**:
+- **Trigger Entity**: `light.bedroom`
+- **Immediate Single Press**: ✅ Enabled
+- **Single Press Action**: Leave empty (light toggles naturally)
+- **Double Press Action**:
+```yaml
+  - choose:
+      - conditions:
+          - condition: sun
+            after: sunset
+        sequence:
+          - service: scene.turn_on
+            target:
+              entity_id: scene.bedroom_bright_night
+      - conditions:
+          - condition: sun
+            before: sunset
+        sequence:
+          - service: scene.turn_on
+            target:
+              entity_id: scene.bedroom_bright_day
+```
+
+#### Example 2: Button with Escalating Actions
+
+**Use Case**: Button that does more based on number of presses
+
+**Configuration**:
+- **Trigger Entity**: `binary_sensor.my_button`
+- **Immediate Single Press**: ❌ Disabled (wait to see if multi-press)
+- **Single Press Action**: Turn on TV
+- **Double Press Action**: Turn on TV + soundbar + dim lights
+- **Triple Press Action**: Full movie mode (TV + soundbar + lights off + close blinds)
+- **Quad Press Action**: Party mode
+
+#### Example 3: Bathroom Light with Time-Based Logic
+
+**Configuration**:
+- **Trigger Entity**: `light.bathroom`
+- **Immediate Single Press**: ✅ Enabled
+- **Triple Press Action**:
+```yaml
+  - choose:
+      - conditions:
+          - condition: time
+            after: "22:00:00"
+            before: "06:00:00"
+        sequence:
+          - service: light.turn_on
+            target:
+              entity_id: light.bathroom
+            data:
+              brightness_pct: 10
+              color_temp: 454
+      default:
+        - service: light.turn_on
+          target:
+            entity_id: light.bathroom
+          data:
+            brightness_pct: 100
+```
+
+### Updates
+
+To get the latest version of this blueprint:
+
+1. Go to **Settings → Automations & Scenes → Blueprints**
+2. Find **"Multi-Press Action"** in your list
+3. Click the **⋮** menu (three dots)
+4. Select **"Re-import Blueprint"**
+5. Your existing automations will automatically use the updated version
+
+### Changelog
+
+#### v1.0.0 (2025-10-25)
+- Initial release
+- Support for single, double, triple, and quad press actions
+- Configurable time window
+- Optional immediate single-press mode
+- Full action sequence support with conditions
+
+### Tips
+
+- **Immediate mode** (default): Best for switches that control things directly (like lights). No delay on single press.
+- **Delayed mode**: Best for buttons that only trigger automations. Waits to see if you're doing a multi-press.
+- **Time window**: Start with 1.5s. Increase if you have trouble with multi-press detection, decrease for faster response.
+- **Action complexity**: Each action input supports full Home Assistant action sequences - use conditions, choose blocks, multiple services, etc.
+
+### Troubleshooting
+
+**Multi-press not detecting:**
+- Increase the time window
+- Check that your entity is actually changing state rapidly
+- Look at Developer Tools → Events to watch `state_changed` events
+
+**Single press delayed even in immediate mode:**
+- Make sure "Execute Single Press Immediately" is enabled
+- Check that your single press action isn't empty (unless you want the natural entity behavior)
+
+**Automation not working:**
+- Check the automation trace (Settings → Automations → your automation → ⋮ → Traces)
+- Verify your trigger entity is the correct one
+- Test with simple actions first (like notifications)
+
+### Support
+
+Found a bug or have a feature request? Open an issue on the repository!
+
+### License
+
+Feel free to use, modify, and share this blueprint!