Skip to content
Read data from you Domoticz system
JavaScript CSS
Branch: master
Clone or download
Latest commit bcd46b6 Sep 4, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Initial commit Mar 9, 2018
MMM-Domoticz.js
README.md Update README.md Sep 4, 2019
String.format.js First commit Mar 9, 2018
domoticz.css Readded sensor, spacing submenu, padlock icon Jan 11, 2019
domoticz.less First commit Mar 9, 2018
node_helper.js First commit Mar 9, 2018
screendomoticz.png New screen print icons and levels Mar 19, 2018

README.md

MMM-Domiticz

This MagicMirror module allows you read data from your Domiticz Home Center

Important message

Due to a great number of requests that I am not able to implement, mostly simply because I don't have the same devices connected to my Domoticz system there will be no more new features added to this module. In the past some addiditions have been made that probably is only used by the user that requested it. It is not possible to award every request.

Installation

  1. Navigate into your MagicMirror's modules folder and execute git clone https://github.com/spoturdeal/MMM-Domoticz.git.
  2. Add the module inside config.js placing it where you prefer ;)

Config

Option Description
updateInterval How fast do you like updates.
Type: Integer
Default: 45
apiBase The IP Address of your Domoticz.
Type: string
Default: 192.168.xxx.xxx
apiPort The port your Domiticz uses.
Type: Integer
Default: 8080
apiUser The username you use to login on your Domoticz.
Type: string
Default: XXXX
apiPw The password you use to login..
Type: string
Default: xxxx
energyTitle Energy title.
Type: string
Options: Anything
Default: Energy used by
batteryTitle Battery title.
Type: string
Options: Anything
Default: Battery level
coTitle CO2 title.
Type: string
Options: Anything
Default: CO2 level
blindsTitle Blinds title.
Type: string
Options: Anything
Default: Blinds
voltageTitle Voltage title.
Type: string
Options: Anything
Default: Voltage/Current
alarmTitle Alarm title.
Type: string
Options: Anything
Default: Alarm system
alarmLabel Alarm label.
Type: string
Options: Anything
Default: Current alarm status:
rainLabel Rain label.
Type: string
Options: Anything
Default: Rain meter:
energyNow The text for the energy you currently use.
Type: string
Default: Currently
energyTotal The text of total energy used.
Type: string
Default: Total used
energyMeter1 Label for energymeter 1.
Type: string
Default: kWh meter I
energyMeter2 Label for energymeter 2.
Type: string
Default: kWh meter II
gasTotal The text of total gas used.
Type: string
Default: Total gas used
gasToday The text of total gas used today.
Type: string
Default: Today used gas
waterTotal The text of total water used.
Type: string
Default: Total H2O used
waterToday The text of total water used today.
Type: string
Default: Today used H2O
moduleTitle Defines the headline text.
Type: string
Default: My smart home by Domoticz
temperatureTitle Defines the temperature text.
Type: string
Default: Current temperatures Domoticz
batteryThreshold Below this value it will be shown.
Type: Integer
Default: 15
coThreshold Above this level in ppm it will be shown.
Type: Integer
Default: 700
showItems The items you like to show.
Type array
One of the following: temperature, energy,battery,co,blinds,humidity,baro,usage,voltage,alarm,sensor,pulse,meter
Default ['temperature','energy','usage','meter']
subMenus Set if you want separate menus.
Type: boolean
Options: true, false
Default: true
smartMeter Set to true if you use a P1 USB smart meter.
Type: boolean
Options: true, false
Default: false
smartMeterOffset Set the beginning value of your smart meter.
Type: integer
Default: 0
smartMeterGasOffset Set the beginning value of your smart gas meter.
Type: integer
Default: 0
smartMeterWaterOffset Set the beginning value of your smart water meter.
Type: integer
Default: 0
excludeDevices The device you like to show wich are ON.
Type array
One of the following: Livingroom, Garden lights
Default none
onlyShowExcluded Only shows the devices that are in the excludedDevices array.
(For backward compatibility didn't change the name excludedDevice setting)
Type boolean
Default false
textWhite Set the text colour to white instead of grey.
Type boolean: true of false
Default false
alarmOffLabel Label if alarm is off.
Type: string
Options: Anything
Default: Security Disarmed
alarmOnLabel Label if alarm is armed.
Type: string
Options: Anything
Default: Security Armed
groupSensors Group the values of one sensor. If true the name will not repeat and a hook is shown. On position left it sometimes give strange effects.
Type boolean: true of false
Default false

Here is an example of an entry in config.js

{
	module: "MMM-Domoticz",
	position: "top_right",   // see mirror setting for options
	config: {          
		updateInterval: 45, // every 45 seconds
		apiBase: '192.168.xxx.xxx',
		apiPort: 8080,
		apiUser: "XXXX",
    		apiPw: "xxxx",
		moduleTitle: "My smart home by Domoticz",
		energyTitle: "Energy used by",
		batteryTitle: "Battery level",
		coTitle: "CO2 level",
		blindsTitle: "Blinds",
		energyNow: "Currently using",
		energyTotal: "Energy used",
		energyToday: "Energy used today",
		batteryThreshold: 20,
    		coThreshold: 650,
		subMenus: true,
		smartMeter: false,
		smartMeterOffset: 0,
		showItems: ['temperature','energy','battery','co','blinds','humidity','baro','usage','voltage','alarm','sensor','pulse','meter','rain'],   
		excludeDevices: ['none','add your own'],  // Device that will not be shown
		onlyShowExcluded: false, // if true only exluded devices are shown
		textWhite: false,
		alarmOffLabel: "Disabled",
		groupSensors: false
	}
}

Screenshots

Display type: details

Screenshot of detail mode

Use an ESP32 WiFi module to controll your shutters

Control your shutter with WiFi asnd ESP32 module

22th April 2018

Added Humidity and Barometric pressure. Must be added in config.js to be shown grouped on the sensors name.

23th April 2018

Added current use of Watts please update config.js showItems with 'usage' Added total and todays use of energy in kWh.

24th October 2018

Added alarm status requested by jacha05 Added Voltage and current requested by offgridonrocker Changed error in example config.js (typo in excludedDevices is now excludeDevices).

15th Januari 2019

Added Alarm system texts update the config if needed Re-Added Sensors made by BlackCatDeployment Restructured layout scripts.

21st May 2019 v1.18

Added support for SmartMeter p1 through USB Added SmartMeter offset requested by 1kOhm Changed excluded device to make it possible to only show selected Device requested by RienduPre Changed power usage metering if using a smartmeter requested by RienduPre

25th May 2019 v1.24

Added smartMeter for Gas and Water Added support for SO pulse meters

26th May 2019 v1.26

Added meter values

30th June 2019 v1.35

Added rain meter

The MIT License (MIT)

Copyright © 2019 SpoturDeal - Carl

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

You can’t perform that action at this time.