Open Source Home Automation Software for Linux
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
DomotiGa3 Fixed: MQTT plugin didn't act on heartbeat timeouts Oct 8, 2018
DomotiGaServer3 Fixed: MQTT plugin didn't act on heartbeat timeouts Oct 8, 2018
certificate Added: Default SSL certificate Apr 8, 2016
development Added: JSON-RPC basic HTTP authentication in domotiga.conf/server-dom… Apr 27, 2018
floorplans New version 0.1.170, you must upgrade your database! Sep 14, 2009
icons Added: Velbus VMBGP4PIR module supported Feb 10, 2017
install Fixed: Domotiga install didn't work on MySQL 8.0 Jul 19, 2018
logs Updated: Centralize gitignore file Aug 12, 2014
rrd/graphs Added: Width and Height settings for RRDTool Graphs Nov 24, 2014
sounds Domotiga import 0.1.158 including b-bugfix devices Nov 29, 2008
tfa Added: Two factor authentication support, needs more testing. Thanks … Jun 1, 2016
tools Added: eibd (KNX) start-up script Aug 24, 2018
tvguide Add: folders for Gambas Feb 3, 2014
upgrade Added: MQTT can send all values during start-up (configurable) Jan 11, 2018
webclients Changed: Simple Webclient will not show hidden devices Apr 11, 2018
wrappers Changed: Remove all jsonlib call from DomoZWave wrapper Aug 22, 2018
.gitattributes Added .gitattributes Jul 26, 2014
.gitignore Added: JSON-RPC Server settings supports SSL Mar 29, 2016
AUTHORS New version 0.1.203, you must upgrade your database. Feb 12, 2012
CHANGELOG Update CHANGELOG Jul 4, 2014
COPYING Renamed LICENSE to COPYING. Dec 2, 2008
DomotiGa3.desktop Fixed: Convert Plugwise device adressess to upper case before usage. Aug 31, 2014
DomotiGa3.gambas Fixed: MQTT plugin didn't act on heartbeat timeouts Oct 8, 2018
DomotiGaServer3.desktop Fixed: Permissions and name of Desktop icons. Aug 31, 2014
DomotiGaServer3.gambas Fixed: MQTT plugin didn't act on heartbeat timeouts Oct 8, 2018
Gambas3.desktop Provide example desktop shortcuts. Jul 2, 2013
README.md Changed: Made K8055 plugin support multi-instances. Apr 5, 2015
TODO Fixed: Removed done items from TODO list. Feb 4, 2014
domotiga.conf.default Added: MySQL Port setting for Docker support. Nov 28, 2014
server-domotiga.conf.default Added: MySQL Port setting for Docker support. Nov 28, 2014

README.md

DomotiGa - Open Source Home Automation for Linux

Thank you for your interest in DomotiGa! DomotiGa is Home Automation software for Linux written in Gambas Basic, an excellent programming language and IDE for Linux.

DomotiGa has grown over the years from a tool to monitor sensors with via RFXCom interface, but nowadays you can use it to read and log data from all kind of interfaces, let it detect motion and schedule lights or appliances at certain times. Or get events triggered by actions of other hardware and/or software modules, called 'plugins'. Sending push messages via Twitter, Pushbullet, Pushover and NMA are also possible.

DomotiGa supports a long and growing list of various plugins to support for example the versatile RFXComTRX transceiver, a Razberry board on your Pi or the AEON Labs Open-Zwave dongle, Smartmeter P1 port, Plugwise dongle and more...

Directory Structure

README.md        you are reading it now
CHANGELOG        contains a link to where to find changes between versions
COPYING          the GPL license
AUTHORS          the author(s)
TODO             things to do

DomotiGa3/       the Gambas3 source code for client/standalone
DomotiGaServer3/ the Gambas3 source code for server
rrd/             rrd databases and graphs are stored here
logs/            this is where DomotiGa stores it's logfiles
icons/           icons used for devices
install/         files needed for fresh database install
	domotiga.sql        example database layout and contents
	domotiga-empty.sql  empty database layout and contents
floorplans/      store your floorplan images here
tvguide/         directory for xml tvguide related files
upgrade/         files needed for upgrading the database
sounds/          sounds to play
tools/           stores startup scripts and other tooling
wrappers/        3rd party library wrappers
webclients       web and smartphone clients

Requirements

Depends on which setup U want to use (see below) you want to use, but minimum is Gambas 3.6.0 for the server/client GUI. To use one of the web clients you need to install a webserver like nginx or Apache, with PHP.

Clients and Server

You have a few choices on how you want DomotiGa to setup:

  • Standalone You can have a standlone GUI (DomotiGa3) as server and client. You do this by setting the Mode to 'server' in the config file. This is the default and will talk to all enabled hardware. You need server hardware with XWindows installed with a monitor or working VNC setup.

  • GUI client(s) and CLI server You can run the DomotiGaServer3 as server to talk to the hardware and DomotiGa3 as clients, you have to change the Mode parameter in domotiga.conf from server to client on the machines you run DomotiGa3 on.

  • GUI client(s) and GUI server You can use the standalone version as server, but with more DomotiGa instances as clients. So you configure on with server as Mode parameter, and the others as client, make sure the mysql host, xmlrpc and udp broadcast settings are set correctly for this.

  • Web client(s) On low performance hardware is often better to only run the CLI server (DomotiGaServer3) Together with nginx or Apache as webserver and DomotiYii as the webclient.

DomotiYii is still under development, so if it doesn't do what you want right now, give us a poke!

Hardware

Gambas and thus DomotiGa can run on a variety of server hardware, read more info here Popular are the Cubieboard 2 or Cubietruck (with SSD), for a very small/test setup the Rasberry Pi can just handle it.

Install Documentation

You can find all information on our website domotiga.nl

A draft version of the User Guide is also available.

Some more reading material:

Introduction

How to Start

Installation

Changelog

Screenshots

https://domotiga.nl/projects/domotiga/wiki/DomotiGa_Screenshots

License

DomotiGa is released under the GNU GPL V3 License Full Text Version.

Copyright (C) Ron Klinkien, The Netherlands.

Disclaimer

DomotiGa comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law.

Make sure you have read the license file called COPYING, or the programs About window contents. If you do not agree with it please remove this program from your computer.

Debugging

If things don't work correctly enable debug information for the part or plugin you have trouble with and examine the debug log.

You can post your issues or ask questions on the forum, open a bug report or just send me a message via the Contact form on the site.

Development

If you have written some code, or want to help make DomotiGa better, please contact us, or fork this project and submit a Pull Request on GitHub. Gambas is a great (and free) programming language and it comes with a very nice IDE to develop with. If your not familiar with Gambas visit the website and/or wiki for more information.

Donate

If you want to have suppport for your home automation hardware, you can donate a sample, lend it to me, or send me the specs and I see what I can do. ;-) You can also use PayPal if you like the project.

Thanks to the guys at www.domoticaforum.eu, www.rfxcom.com, www.ezhome.nl and www.domotica-shop.nl!

HAVE FUN NOW!

Regards, Ron Klinkien aka RDNZL support@domotiga.nl The Netherlands