{"id":22352074,"url":"https://github.com/bertreb/pimatic-gbridge","last_synced_at":"2025-07-06T12:37:33.332Z","repository":{"id":57324211,"uuid":"221413382","full_name":"bertreb/pimatic-gbridge","owner":"bertreb","description":"Plugin that connects a Pimatic home automation system with Google assistant","archived":false,"fork":false,"pushed_at":"2020-03-26T08:48:23.000Z","size":94,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-03T11:09:17.547Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CoffeeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bertreb.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-13T08:48:25.000Z","updated_at":"2020-12-30T00:50:13.000Z","dependencies_parsed_at":"2022-09-21T00:54:20.157Z","dependency_job_id":null,"html_url":"https://github.com/bertreb/pimatic-gbridge","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bertreb/pimatic-gbridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertreb%2Fpimatic-gbridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertreb%2Fpimatic-gbridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertreb%2Fpimatic-gbridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertreb%2Fpimatic-gbridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bertreb","download_url":"https://codeload.github.com/bertreb/pimatic-gbridge/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertreb%2Fpimatic-gbridge/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263901592,"owners_count":23527438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-04T12:17:03.521Z","updated_at":"2025-07-06T12:37:33.314Z","avatar_url":"https://github.com/bertreb.png","language":"CoffeeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"pimatic-gbridge\n===================\n# The gBridge service ended the 15th of March 2020. \n\nThis plugin can still work if you use a self hosted gbridge service.\n\n---\nThe gBridge plugin lets you connect a Pimatic home automation system with a Google assistant via gBridge.\nWhen you add a supported Pimatic device to the gBridgeDevice devicelist, the device is automatically added in gBridge and Google Assistant.\n\ngBridge is a MQTT broker that 'works with Google'. First you create a gBridge account, connect your google (assistant) account to gBridge and obtaining an API key. Then you can configure the plugin and add devices to be controlled via Google Assistant. Details for setup and configuration at https://about.gbridge.io.\nThe number of supported devices is depending on the gBridge plan you've got. The free plan allows 4 devices and the paid plan gives an unlimited number of devices.\nDevices are not exposed automatically to gBridge and Google Assistant. You have to add them individually in the config.\n\n\nInstallation\n------------\nTo enable the gBridge plugin add this to the plugins section via the GUI or add it in the config.json file.\n\n```\n...\n{\n  plugin: \"Gbridge\"\n\nOptions to configure in the plugin settings:\n  gbridgeApiKey:        \"The apikey to get an access_token\"\n  gbridgeSubscription:  \"The type of subscription; Free (max 4 devices) Standard or (unlimited)\"\n  mqttServer:           \"Hosted gBridge servername\" (default mqtt.gbridge.io)\n  mqttProtocol:         \"The used protocol for hosted MQTT server. MQTT (default) or MQTTS\"\n  mqttUsername:         \"The mqtt hosted server username\"\n  mqttPassword:         \"The mqtt hosted server password\"\n  certPath:             \"Path to the certificate in PEM format for the MQTTS/TLS connection\"\n  keyPath:              \"Path to the key in PEM format,  for the MQTTS/TLS connection\"\n  caPath:               \"Path to the trusted CA list\"\n  gbridgeServer:        \"The gBridge api server address\" default: \"https://gbridge.kappelt.net/api/v2\"\n  gbridgeUser:          \"The gbridge username\"\n  gbridgePassword:      \"The gbridge password\"\n  debug:                \"Debug mode. Writes debug messages to the pimatic log.\"\n}\n...\n```\n\nGbridge device\n-----------------\nAfter the plugin is installed a Gbridge device can be added.\n\nBelow the settings with the default values. In the devices your configure which Pimatic devices will be controlled by Google Assistant and what name they get. The name is visible in the Google Assistant and is the name you use in voice commands.\nIn this release the SwitchActuator, DimmerActuator, ButtonsDevice, ShutterController, Milight (RGBWZone and FullColorZone), HeatingThermostat, Contact and Temperature/Humidity sensor based Pimatic devices are supported.\nWhen there's at least 1 device in the config, the dot will go present after a connection to gBridge and the mqtt server is made.\n\n\n\n#### Shutter\nFor the Shutter device the auxiliary field is used to control a shutter via a shell script. The position of the shutter (the value) is added at the end of the script (with a space) before executing the script. A return value is used as actual shutter position.\n\nMore info on Shutter voice commands on [gBridge](https://doc.gbridge.io/traits/openclose.html)\n\n#### Milight\nFor the Milight devices automatic configuration is not implemented. You need to configure the milight device in gBridge (with the traits 'OnOff', 'Brightness' and 'colorsettingrgb') and after that configure(add) the milight device in config of the gBridge device in Pimatic. The name you used for the Milight device in gBridge must by exactly the same as the name in pimatic gBridge! When you want to change the name of a Milight device you have to reinstall it in gBridge (because automatic configuration isn't supported)\n\nMore info Brigtness voice commands on [gBridge](https://doc.gbridge.io/traits/brightness.html)\n\n#### Contact\nYou can add a Pimatic contact device to gBridge.\nYou give the contact a name that is usable with Google Assistant. The contact device id is put into the pimatic_device_id field. The rest of the fields is not used.\nYou can ask Google Assistant what de status of the contact-name is, or if a contact-name is opened or closed.\n\nMore info on contact voice commands on [gBridge](https://doc.gbridge.io/traits/openclose.html)\n\n#### Thermostat\nFor the HeatingThermostat you CAN add a temperature/humidity sensor. In the auxiliary field, add the device-id of the temperature/humidity sensor. The sensor needs to have 'temperature' and 'humidity' named attributes. If the attribute names are different, you can put a variables devices 'in between' (which converts the attribute names to 'temperature' and 'humidity').\nThe heating device is only using the temperature setting of the device.\nThe following modes are supported: off, heat and eco.\n\nMore info on Thermostat voice commands on [gBridge](https://doc.gbridge.io/traits/temperaturesetting.html)\n\n#### Temperature\nThe temperature/humidity sensor is not supported directly by gBridge and Google Assistant. This temperature/humidity sensor via implemented via a DummyThermostat.\nThe configuration is as follows:\n- pimatic_device_id: the Temp/Hum device-id of the Pimatic Sensor\n- auxiliary: the attribute name of the temperature attribute of the Pimatic sensor\n- auxiliary2: if available the attribute name of the humidity attribute of the Pimatic sensor\n\nIn the Google Assistant (or Home app) you hear/see a thermostat device with the same ambiant(room) and setpoint temperature. This value is the temperature value of your Pimatic sensor.\n\nDevice configuration\n-----------------\n\n```\n{\n  \"id\": \"\u003cgbridge-device-id\u003e\",\n  \"class\": \"GbridgeDevice\",\n    devices:  \"list of devices connected to Google Assistant\"\n      name:                 \"the gBridge device name, and command used in Google Assistant\"\n      pimatic_device_id:    \"the ID of the pimatic device\"\n      pimatic_subdevice_id: \"the ID of a pimatic subdevice, only needed for a button id\"\n      auxiliary:            \"adapter specific field to add functionality to the bridge\"\n      auxiliary2:            \"2nd adapter specific field to add functionality to the bridge\"\n      twofa:                 \"Two-step confirmation. Google Assistant will ask for confirmation\"\n                              [\"none\", \"ack\"] default: \"none\"\n}\n```\n\n#### Deleting a gBridge device\nBefore you delete a gBridge device, please remove first all devices in the config and save the config. After that you can delete the gBridge device.\nIf you deleted the gBridge device before deleting the used devices, you must delete the devices in the gBridge management portal.\n\n-----------------\n\nThe plugin is Node v10 compatible and in development. You could backup Pimatic before you are using this plugin!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbertreb%2Fpimatic-gbridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbertreb%2Fpimatic-gbridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbertreb%2Fpimatic-gbridge/lists"}