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
- LIRC infra-red transmitters
- MQTT
- Jabber
- REST API
- 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 mosquitto installed:
$ apt-get install mosquitto
$ service mosquitto start
$ packer -S mosquitto
$ systemctl enable --now mosquitto
An example configuration is at: https://github.com/barnybug/gohome/blob/main/config.yml
Edit this to match your setup and upload:
$ curl -XPOST localhost:8723/config?path=config --data-binary 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) 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 $GOPATH/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.