HSBuddy

A mobile client for HomeSeer

Connection setup

HSBuddy uses the JSON API exposed by HomeSeer to control devices and events. Additionally, you may install the HSBuddy plug-in on your HomeSeer server to enable additional functionality, like viewing cameras or server logs. There are 2 modes in which HSBuddy can connect to your HomeSeer server: Direct Connection and via MyHomeSeer.

Follow the steps outlined in the next sections to allow HSBuddy to connect to your server using either of the 2 methods.

Connecting via MyHomeSeer

MyHomeSeer connection diagram

The MyHomeSeer service is offered to HomeSeer users at no additional charge for a single server connection. When using MyHomeSeer, your server connects to MyHomeSeer and is remotely accessible through their service. To setup your server to connect to MyHomeSeer you must:

  1. Create an account at https://myhs.homeseer.com/
  2. Enable MyHomeSeer Remote Control in your server:
    • Go to Tools > Setup > Network
    • Choose to Enable remote access through MyHomeSeer service

MyHomeSeer settings

Direct Connection

Direct connection diagram

An alternative to using MyHomeSeer is setting up your server such that it is accessible via your home’s local network and (optionally) through the Internet. You can do that by following these steps:

1. Enable local network access

To allow local network access to your server, follow these steps:

  1. Go to Tools > Setup > Network
  2. Choose to Enable Server for Remote Access and select your desired port (80 by default)

Local Network Access settings

  1. Optional. You may need to configure your server’s firewall to allow connections to the selected port.

2. Enable Internet access

When allowing access to your server through the Internet, I strongly recommend using secure connections. For more information, see: Direct Access

To allow Internet access to your server, in addition to the steps in the previous section, you may need to complete one or more of the following:

3. Configure User Accounts

If you connect to your server via Nginx (recommended), you do not need to cnofigure user accounts here. Instead you need to create a user/password file for Nginx. For more information see Direct Access.

If you are using a direct connection to your server you will need to create an account and password to connect to your server. You can do this following these steps in your server:

  1. Go to Tools > Setup > Network
  2. Add or configure a user name and password.

User Account settings

Server Plug-in

The HSBuddy plugin for HomeSeer will make additional functionality available to the HSBuddy app, including:

Requirements

Please make sure your HomeSeer server meets the following requirements, based on its operating system.

For Windows:

You will need Windows 7 or later. If you are on Windows 7, make sure that the .NET Framework 4.5 is installed.

For Linux (x86/64):

You will need to install the mono-devel package, for example:

sudo apt-get install mono-devel

For Linux (Raspberry Pi):

You will need to install the mono-devel and libsqlite3-0 packages, for example:

sudo apt-get install mono-devel
sudo apt-get install libsqlite3-0

Installation

You can install the plugin directly from within HomeSeer. Head to the Plugin Management page (PLUG-INS -> Manage) and look for HSBuddy under the User Interfaces section.

Configuration

Once the plug-in is installed you will find it listed along with the rest of your installed plugins if you go to PLUG-INS -> Manage. You will also find a new HSBuddy Section under the PLUG-INS menu:

Installed plug-ins page

Click on the HSBuddy link under the menu or in the list of installed plug-ins and you will be taken to the configuration page: