{"id":26457108,"url":"https://github.com/sobakasu/mqtt-homie","last_synced_at":"2026-03-15T14:09:27.421Z","repository":{"id":56884664,"uuid":"194012025","full_name":"sobakasu/mqtt-homie","owner":"sobakasu","description":"A ruby interface for creating a device conforming to the MQTT Homie convention.","archived":false,"fork":false,"pushed_at":"2025-06-14T04:02:56.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-24T04:08:12.215Z","etag":null,"topics":["homie","homie-convention","mqtt","mqtt-client","mqtt-protocol","ruby","ruby-gem"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/sobakasu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-06-27T02:54:16.000Z","updated_at":"2025-06-14T04:02:59.000Z","dependencies_parsed_at":"2025-06-24T04:08:15.903Z","dependency_job_id":"f475d8ff-5be0-4e61-aa10-403ed4f8c1dc","html_url":"https://github.com/sobakasu/mqtt-homie","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sobakasu/mqtt-homie","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobakasu%2Fmqtt-homie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobakasu%2Fmqtt-homie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobakasu%2Fmqtt-homie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobakasu%2Fmqtt-homie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sobakasu","download_url":"https://codeload.github.com/sobakasu/mqtt-homie/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sobakasu%2Fmqtt-homie/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265088850,"owners_count":23709595,"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":["homie","homie-convention","mqtt","mqtt-client","mqtt-protocol","ruby","ruby-gem"],"created_at":"2025-03-18T22:42:13.612Z","updated_at":"2026-03-15T14:09:27.392Z","avatar_url":"https://github.com/sobakasu.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MQTT::Homie\n\nA ruby interface for creating a device conforming to the MQTT [Homie] convention.\nThis gem builds upon the [ruby-mqtt] ruby gem.\n\nThe [Homie] convention defines a standardized way of how IoT devices and services announce themselves and their data to a MQTT broker.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'mqtt-homie'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install mqtt-homie\n\n## Quick Start\n\n~~~ ruby\nrequire 'rubygems'\nrequire 'mqtt/homie'\n\n# Set up a device, with a node and properties\ndevice = MQTT::Homie.device_builder(id: 'device', name: 'Device')\n  .node(id: \"gate\", name: \"Front gate\", type: \"Gate\")\n  .property(id: \"state\", name: \"Gate state\", enum: [:open, :closed, :opening, :closing], value: :closed)\n  .property(id: \"position\", name: \"Gate position\", datatype: :integer, unit: \"%\", value: 0)\n  .property(id: \"command\", name: \"Send gate command\", settable: true, enum: [:open, :close]).build\n\n# Create a client and connect to a MQTT broker\nclient = MQTT::Homie::Client.new(device: device, host: 'localhost')\nclient.connect\n\n# access nodes and properties of the device\nnode = device.node('gate')\nstate = node.property('state')\nstate.value = :open  # publishes new state to MQTT\n\n# listen for changes to properties via the Observer interface\nnode.property('command').add_observer(self)\n~~~\n\n## Overview\n\nTODO\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n## Code of Conduct\n\nEveryone interacting in the Mqtt::Homie project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/mqtt-homie/blob/master/CODE_OF_CONDUCT.md).\n\n\n\n[Homie]: https://homieiot.github.io/\n[MQTT]:  http://www.mqtt.org/\n[ruby-mqtt]: https://github.com/njh/ruby-mqtt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsobakasu%2Fmqtt-homie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsobakasu%2Fmqtt-homie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsobakasu%2Fmqtt-homie/lists"}