homebridge-switchbot-for-mac

KO | EN

gitlite — search

#python #hacktoberfest #llm #golang #go #docker #macos #awesome #kubernetes #awesome-list #vue #ios #openai #open-source

homebridge-switchbot-for-mac

(★ 19)

Homebridge SwitchBot is plugin for Homebridge that allows you to manage SwitchBot.

homebridge-switchbot-for-mac 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Homebridge SwitchBot

[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[![npm version](https://badgen.net/npm/v/homebridge-switchbot-for-mac)](https://www.npmjs.com/package/homebridge-switchbot-for-mac)
[![npm downloads](https://badgen.net/npm/dt/homebridge-switchbot-for-mac)](https://www.npmjs.com/package/homebridge-switchbot-for-mac)

</span>

Homebridge SwitchBot is plugin for [Homebridge](https://github.com/nfarina/homebridge) that allows you to manage [SwitchBot (the Bot)](https://www.switch-bot.com/bot) like a switch accessory on the Home app.

## Supported SwitchBot devices
* [SwitchBot (the Bot)](https://www.switch-bot.com/bot)

## Supported OS versions

### macOS
* macOS version 10.15 or later
* Install [Xcode](https://itunes.apple.com/ca/app/xcode/id497799835?mt=12)

#### Big Sur
Set to manually grant Bluetooth access in System Preferences UI for `Security & Privacy -> Privacy` to the `node` executable. 
![Security & Privacy -> Privacy](https://raw.githubusercontent.com/zizi4n5/homebridge-switchbot-for-mac/master/assets/bigsur-security-privacy-bluetooth.png)
The symlink part is important. If you installed node via homebrew, you cannot grant Bluetooth privileges to `/usr/local/bin/node`, but have to target `/usr/local/Cellar/node/x.x.x/bin/node` explicitly.

### Raspbian(Linux-based OS)
* Kernel version 3.6 or later
* libbluetooth-dev

```bash
sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev
```

If [@abandonware/noble](https://github.com/abandonware/noble) is installed properly, this module might work well on other Linux-based OSes, such as Ubuntu, Debian and so on. See the document of the [@abandonware/noble](https://github.com/abandonware/noble#linux) for details.

## Dependencies

* Node.js 10 +
* [@abandonware/noble](https://github.com/abandonware/noble)
* [@zizi4n5/node-switchbot](https://github.com/zizi4n5/node-switchbot)

## Installation

Install the npm package:

```bash
sudo npm install -g --unsafe-perm homebridge-switchbot-for-mac
```

---
## How to Use

Find your SwitchBot's MAC address (BLE MAC) with the official iOS/Android app, and add an accessory definition to `~/.homebridge/config.json`:

### e.g. Use one SwitchBot

```config.json
{
    "accessories": [
        {
            "accessory": "SwitchBot-For-Mac",
            "name": "Switch",
            "delay": 5000,
            "retries": 3,
            "macAddress": "01:23:45:67:89:AB",
            "ping": {
                "ipAddress": "127.0.0.1",
                "interval": 2000,
                "retries": 1,
                "timeout": 1000
            }
        }
    ]
}
```

### e.g. Use two SwitchBots

```config.json
{
    "accessories": [
        {
            "accessory": "SwitchBot-For-Mac",
            "name": "Switch",
            "delay": 5000,
            "retries": 3,
            "on": {
                "macAddress": "CD:E0:12:34:56:78"
            },
            "off": {
                "macAddress": "9A:BC:DE:01:23:45"
            },
            "ping": {
                "ipAddress": "127.0.0.1",
                "interval": 2000,
                "retries": 1,
                "timeout": 1000
            }
        }
    ]
}
```

---
## Settings

### Use one SwitchBot Settings

Settings for switching on/off using one SwitchBot.

### Use two SwitchBots Settings

Settings for switching on/off using two SwitchBots.

### Advanced - Ping Settings

Settings for update the status with ping communication.  
You can only set it if you can using ping to determine if the device is on or off.  
Otherwise, do not set it.

homebridge-switchbot-for-mac

homebridge-switchbot-for-mac 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

homebridge-switchbot-for-mac

homebridge-switchbot-for-mac 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README