Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including homee-api with all npm packages installed. Try it out:

var homeeApi = require("homee-api")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

homee-api v0.11.1

a library to interact with homee

homee API wrapper

work in progress

a library to interact with homee


npm install homee-api --save



const Homee = require('homee-api');

const homee = new Homee(host, user, password, options);

homee.connect().then(() => {
}).catch((error) => {


        device: 'homeeApi',
        reconnect:  true,
        reconnectInterval: 5000,
        maxRetries: Infinity


    // handle at least the "error" event to prevent crashing
    homee.on('error', (err) => {});
    homee.on('message', (message) => {});
    homee.on('connected', () => {});
    homee.on('reconnect', (retries) => {})
    homee.on('disconnected', (reason) => {});
    homee.on('maxRetries', (maxRetries) => {});
    // special events
    homee.on('user', (user) => {})
    homee.on('attribtue', (attribute) => {})
    homee.on('nodes', (nodes) => {})
    homee.on('history', (type, data) => {})
    // ...tbc


// send any message
homee.send('your-message, i.E. GET:nodes');

// homeegram interactions

// update an attributes target_value
homee.setValue(device_id, attribute_id, value);

// group interactions
homee.createGroup(name, image);
homee.getNodesByGroup(id); // id or group name

// get diary entries (you should use at least one parameter to shrink the result set)
homee.getDiary(from, till, limit);

// get History for node or attribute (type), from and till are unix timestamps 
homee.getHistory(type, id, from, till, limit);

// close connection

Stored Nodes

The homee api keeps a copy of all your nodes, attributes and groups. Each time the value of an attribute changes, the stored data is also updated. The following attributes give you access to the data at any time.

const nodes = homee.nodes
const attributes = homee.attributes
const groups = homee.groups
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free