
![ceiling-fan.jpg](readme/ceiling-fan.jpg)

# CREATE Ceiling Fan Enhanced

Control your CREATE Ceiling Fan from HomeKit with enhanced features.
- Turn on/off
- Set speed
- Set rotation direction
- Set light on/off
- Control light color temperature ✨
- Control beep sound on/off ✨

![homekit-1.png](readme/homekit-1.png)
![homekit-2.png](readme/homekit-2.png)

## Installation

Go to the Homebridge UI, Plugins screen and search for `homebridge-create-ceiling-fan-enhanced`. Install the plugin and use the form to configure it.

## Features

### ✨ New in Enhanced Version
- **Beep Control**: Toggle the fan's beep sound on/off directly from HomeKit
- **Color Temperature Control**: Adjust light warmth from cool (blue) to warm (yellow)
- **Real-time Sync**: Status updates when changed via physical remote or other apps

### Original Features
- Fan on/off control
- Variable speed control (6 levels)
- Rotation direction control
- Light on/off control

### Optional

If you set `withToggle` to `true`, it will add a new accessory with only switch. This feature allow you to use switch with
on click action.

![toggle.gif](readme%2Ftoggle.gif)

## Configuration

To get your `Id` and `Key` ceiling fan, follow the instructions [Getting your keys](https://github.com/jasonacox/tinytuya/tree/master#setup-wizard---getting-local-keys)

## What You'll See in HomeKit

After installation, you'll have these controls:
- **Fan** (speed and on/off)
- **Light** (on/off and color temperature) ✨  
- **Toggle Light** (simple on/off switch)
- **Beep** (sound on/off) ✨

## Thanks

- [tuyapi](https://github.com/codetheweb/tuyapi)
- @marsuboss
- Original plugin by [moifort/homebridge-create-fan](https://github.com/moifort/homebridge-create-fan)
