SwitchBot-Curtain-3-QuietDrift

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

SwitchBot-Curtain-3-QuietDrift

★ 11 Open GitHub ↗

Unlock the ultra-silent QuietDrift feature on your SwitchBot Curtain 3 directly from Home Assistant.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SwitchBot Curtain 3 QuietDrift for Home Assistant

![Version](https://img.shields.io/badge/version-1.0.0-blue)
![Home Assistant](https://img.shields.io/badge/Home%20Assistant-Custom%20Component-orange)

A native Home Assistant custom component to enable **QuietDrift** mode on SwitchBot Curtain 3 devices.

This component exposes a custom service that allows you to control the position of your curtains with a specific speed parameter, unlocking the silent "QuietDrift" feature that is otherwise unavailable in standard Home Assistant cover calls. It wraps the native Bluetooth library to send precise commands directly to your device.

This project is based on the work by v6ak (https://github.com/v6ak/v6-quietdrift).

⚠️ **Requirements:**
1.  **Firmware**: Your SwitchBot Curtain 3 must be on firmware **v1.2** or newer.
2.  **Integration**: You must use the **native SwitchBot Bluetooth** integration in Home Assistant. This component does **NOT** work with curtains connected via a SwitchBot Hub (Cloud, Matter, or API), as it requires direct Bluetooth command access.

## ✨ Features

*   **🤫 QuietDrift Support**: Unlock the ultra-silent "QuietDrift" mode easily.
*   **⚡ Native Integration**: Works directly with your existing SwitchBot Curtain entities via the native Home Assistant Bluetooth stack.
*   **🛠️ Zero Dependencies**: Does not require external gateways or cloud APIs; operates entirely locally via Bluetooth.
*   **⚙️ UI Installation**: Install easily via HACS and configure via the Home Assistant interface.

## 📥 Installation

### Option 1: HACS (Recommended)

[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Loweack&repository=SwitchBot-Curtain-3-QuietDrift&category=integration)

1.  Open **HACS** in Home Assistant.
2.  Go to the **Integrations** section.
3.  Click the menu (three dots) in the top right corner and select **Custom repositories**.
4.  Paste the URL of this GitHub repository.
5.  Select **Integration** as the category and click **Add**.
6.  Click **Download** on the new "SwitchBot Curtain 3 QuietDrift" card.
7.  **Restart Home Assistant**.

### Option 2: Manual Installation

1.  Download the repository.
2.  Copy the `custom_components/switchbot_curtain_3_quietdrift` folder into your Home Assistant's `homeassistant/custom_components/` directory.
3.  **Restart Home Assistant**.

---

## ⚙️ Configuration

1.  Navigate to **Settings** > **Devices & Services**.
2.  Click **+ Add Integration**.
3.  Search for **SwitchBot QuietDrift Service**.
4.  Confirm the installation. No additional configuration is needed; it simply registers the global service.

---

## 🚀 Usage

You can control your curtains using the `switchbot_curtain_3_quietdrift.set_switchbot_curtain_position` service in Automations, Scripts, or Developer Tools.

### Service: `switchbot_curtain_3_quietdrift.set_switchbot_curtain_position`

**Parameters:**

*   **Entity** (`entity_id`) [Required]:
    The SwitchBot Curtain cover entity. *Note: Must be the direct Bluetooth entity, not a helper group or Cloud entity.*
*   **Position** (`position`) [Required]:
    Target position from **0% (Closed)** to **100% (Open)**.
*   **Speed Profile** (`speed`) [Optional]:
    Select the movement profile:
    *   `QuietDrift`: Ultra-slow, almost silent movement.
    *   `Silent`: Faster than QuietDrift, but quieter than normal.
    *   `Normal`: Standard operation speed (Default).

### Example: Automation (YAML)

Open the curtains silently at sunrise so you wake up naturally:

```yaml
alias: "[Curtain] Sunrise QuietDrift"
description: >-
  Slowly opens the bedroom curtains at sunrise using QuietDrift mode
  to minimize noise.
triggers:
  - trigger: sun
    event: sunrise
    offset: 0
actions:
  - action: switchbot_curtain_3_quietdrift.set_switchbot_curtain_position
    data:
      entity_id: cover.bedroom_curtain
      position: 100
      speed: QuietDrift
mode: single

SwitchBot-Curtain-3-QuietDrift

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

SwitchBot-Curtain-3-QuietDrift

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README