https://github.com/openwonderlabs/node-switchbot

The node-switchbot is a Node.js module which allows you communicate with SwitchBot Devices over BLE
https://github.com/openwonderlabs/node-switchbot

ble nodejs switchbot

Last synced: 3 days ago
JSON representation

The node-switchbot is a Node.js module which allows you communicate with SwitchBot Devices over BLE

• Host: GitHub
• URL: https://github.com/openwonderlabs/node-switchbot
• Owner: OpenWonderLabs
• License: isc
• Created: 2019-11-20T07:22:21.000Z (almost 5 years ago)
• Default Branch: latest
• Last Pushed: 2024-10-26T10:42:12.000Z (20 days ago)
• Last Synced: 2024-10-30T05:57:42.608Z (16 days ago)
• Topics: ble, nodejs, switchbot
• Language: TypeScript
• Homepage: https://openwonderlabs.github.io/node-switchbot/
• Size: 1.01 MB
• Stars: 71
• Watchers: 5
• Forks: 25
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        


![node-switchbot](https://raw.githubusercontent.com/OpenWonderLabs/node-switchbot/latest/branding/Node_x_SwitchBot.svg?sanitize=true)

# Node-SwitchBot

[![npm version](https://badgen.net/npm/v/node-switchbot)](https://www.npmjs.com/package/node-switchbot)

[![npm downloads](https://badgen.net/npm/dt/node-switchbot)](https://www.npmjs.com/package/node-switchbot)



The `node-switchbot` is a Node.js module that allows you to interact with various SwitchBot devices. You can control your [SwitchBot (Bot)'s](https://www.switch-bot.com/bot) arm, operate your [SwitchBot Curtain](https://www.switch-bot.com/products/switchbot-curtain), and manage your [SwitchBot Lock](https://www.switch-bot.com/products/switchbot-lock). Additionally, you can monitor temperature and humidity using the [SwitchBot Thermometer & Hygrometer (Meter)](https://www.switch-bot.com/meter), and check the status of the [SwitchBot Motion Sensor](https://www.switch-bot.com/products/motion-sensor) and [SwitchBot Contact Sensor](https://www.switch-bot.com/products/contact-sensor).

This module now supports both Bluetooth Low Energy (BLE) and the SwitchBot OpenAPI, providing more flexibility and options for interacting with your devices.

Please note that most of this module was developed by referencing the official [BLE API](https://github.com/OpenWonderLabs/SwitchBotAPI-BLE) and [OpenAPI](https://github.com/OpenWonderLabs/SwitchBotAPI) documentation. However, some functionalities were developed through trial and error, so there might be inaccuracies in the information obtained from this module.

---

## [Installation](https://npmjs.org/node-switchbot)

To install the `node-switchbot` module within your project, use the following command:

```sh

$ npm install --save node-switchbot

```

## [BLE (Bluetooth Low Energy)](BLE.md)

To see a breakdown of how to use the BLE functionality of this project, visit the [BLE (Bluetooth Low Energy)](BLE.md) documentation.

## [OpenAPI](OpenAPI.md)

To see a breakdown of how to use the OpenAPI functionality of this project, visit the [OpenAPI](OpenAPI.md) documentation.

## References

- [SwitchBot (Official website)](https://www.switch-bot.com/)

- [Facebook @SwitchBotRobot](https://www.facebook.com/SwitchBotRobot/)

- [Twitter @SwitchBot](https://twitter.com/switchbot)