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...
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
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!
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.
You can find all information on our website domotiga.nl
A draft version of the User Guide is also available.
Some more reading material:
DomotiGa is released under the GNU GPL V3 License Full Text Version.
Copyright (C) Ron Klinkien, The Netherlands.
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.
If things don't work correctly enable debug information for the part or plugin you have trouble with and examine the debug log.
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.
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.
HAVE FUN NOW!
Regards, Ron Klinkien aka RDNZL firstname.lastname@example.org The Netherlands