/housemon

Real-time home monitoring and automation

Primary LanguageJavaScript

HouseMon

Real-time home monitoring and automation.

More info at http://jeelabs.org/tag/housemon/.

Dependency Status

Note: new developments take place on the master branch of this repository,
but you most probably want a WORKING version, which is in the 0.7.x branch.
The corresponding files on Github are here. See README-0.8.md for the NEW code.

Installation

(Note: go to this page for detailed Raspberry Pi setup instructions)

Install Node.js (it has to be version 0.10.x) and redis, then:

$ git clone https://github.com/jcw/housemon.git
$ cd housemon
$ git checkout 0.7.x    # <== this is ESSENTIAL
$ npm install

Make sure Redis is running (this app uses database #1, see local.json):

$ redis-server &

Then launch the app as a Node.js web server:

$ npm start

Now browse to http://localhost:3333/ (this can be changed in local.json).

Documentation

If you want to start exploring the (early) features of HouseMon, keep these
points in mind and check http://jeelabs.org/tag/housemon/ for the latest news:

  • the "logger" triggers on "incoming" events, as emitted by the "rf12demo" briq
  • the "Readings" page needs drivers and mappings from node ID to that driver
  • the "Status" page also needs mappings from node ID's to named locations
  • the "archiver" and "history" briqs use status changes, so get that going first
  • the "Graphs" page only works off history data so far, i.e. up to 48 hours back

There is some documentation in the docs/ folder, but things do change fast!

License

MIT