https://github.com/devbobo/qmotion

JS library for QMotion blinds
https://github.com/devbobo/qmotion

nodejs qmotion

Last synced: 8 months ago
JSON representation

JS library for QMotion blinds

• Host: GitHub
• URL: https://github.com/devbobo/qmotion
• Owner: devbobo
• License: mit
• Created: 2015-12-18T07:21:46.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2018-07-16T02:32:22.000Z (almost 8 years ago)
• Last Synced: 2025-04-25T22:35:19.873Z (about 1 year ago)
• Topics: nodejs, qmotion
• Language: JavaScript
• Size: 27.3 KB
• Stars: 6
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# JS Library for QMotion Blinds

[![npm package](https://nodei.co/npm/qmotion.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/qmotion/)

[![donate](https://img.shields.io/badge/%24-Buy%20me%20a%20coffee-ff69b4.svg)](https://www.buymeacoffee.com/devbobo)

A NodeJS client for the QMotion blinds (using a QSync device) based on my observations of the network protocol using tcpdump and Wireshark.

# Install

To install from NPM, do ```npm install qmotion```, or just clone the github repo (but you'll need to run ```npm install``` in this dir to get the "clone" dependency if you get from github).

If you install form NPM, then do ```require("qmotion");```. If you cloned the github repo then you'll need to do something like ```require("./qmotion");``` (ie specify the path to the dir you cloned into).

# Files

There is 1 main file (qmotion.js) which is all you need plus some example CLI

apps:

  * cli1.js controls individual blinds

# Usage

The file [cli1.js](cli1.js) is a working example.

To begin with, you must include the library and you can then either create a new QMotion object with a given ip address or find a QSync device using the search function.

Hard coded ip example:

```JavaScript

var qmotion = require('./qmotion');

var device   = new qmotion("192.168.0.1");

```

Network discovery example:

```JavaScript

var qmotion = require('./qmotion');

var client = qmotion.search();

client.on("found", function(device) {

    ...

});

```

Target an individual blind:

```Javascript

var blind = device.blinds[0];

blind.move(50); // open blind to 50%

```

If you want to see debug messages then call

```JavaScript

qmotion.setDebug(true);

```