Home automation for the geek home. Built in Go.

• Lightweight, small memory footprint (runs on the Raspberry Pi)
• Modular, distributed and extendible
• Remotely controllable
• RFID keyless entry
• Smart burglar alarm
• Historic weather monitoring and alerting
• Zoned central heating control
• Automatic plant irrigation system
• Sunset / sunrise triggered home lighting

• rfxcom RFXtrx433 USB device (http://www.rfxcom.com/)
• Homeeasy remote control sockets/lights (http://homeeasy.eu/)
• Arduino with relay module (http://arduino.cc/)
• ZTE 3g modem (ZTE MF110/MF627/MF636, SMS support)
• USB 125KHZ EM4100 RFID Proximity Reader (RFID tag reader)
• Oregon Scientific WMR100/200 weather station
• Audio out (espeak text to speech)
• Foscam wireless IP cameras
• Motion webcam application
• Currentcost electricity monitor

• MQTT
• Nanomsg
• Twitter
• Jabber
• REST API
• Email
• SMS
• Graphite (graphs)
• Wunderground (http://www.wunderground.com/)

Installation is easy, just download the binary from the github releases page (builds are available for Linux 32-bit, 64-bit and ARM): https://github.com/barnybug/gohome/releases/latest

For the raspberry pi, download the ARM build.

Rename and make the download executable:

$ cp gohome-my-platform /usr/local/bin; chmod +x /usr/local/bin/gohome

You also will need redis and mosquitto installed:

$ apt-get install redis
TODO: mosquitto installation steps

$ pacman -S redis
$ systemctl enable redis
$ systemctl start redis

$ packer -S mosquitto
$ systemctl enable mosquitto
$ systemctl start mosquitto

Redis is used to store config.

An example configuration is at: https://github.com/barnybug/gohome/blob/master/config.yml

Edit this to match your setup and upload to redis:

$ redis-cli -x set gohome/config < config.yml

gohome runs as a set of distributed and independent processes/services. They can run across different hosts connecting to the same network, with the pubsub bus (MQTT//nanomsg) connecting all the components together.

To manually run a gohome service:

$ gohome run <service>

The best way to manage the whole set of services is using your user systemd - because you probably want to ensure they are restarted if they happen to crash. Any recent Archlinux comes with this preconfigured, you just need to install the gohome services by running the script setup.sh provided:

$ cd systemd && ./setup.sh

This will enable and start all the services defined in by SERVICES=... in setup.sh.

The 'services' don't necessarily have to be gohome itself - you can add scripts to the system of your own crafting. The script service can wrap external scripts and passes on any events printing to stdout by the external script into gohome, allowing quick and easy integration.

To build yourself from source:

$ go get github.com/barnybug/gohome
$ cd $GOHOME/src/github.com/barnybug/gohome
$ make install

This will produce a binary gohome in ~/go/bin (ie. $GOPATH/bin), after this follow the steps as above.