Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/qwandor/homieflow
A Google Home to Homie MQTT gateway.
https://github.com/qwandor/homieflow
google-home hacktoberfest homie mqtt rust smarthome
Last synced: 11 days ago
JSON representation
A Google Home to Homie MQTT gateway.
- Host: GitHub
- URL: https://github.com/qwandor/homieflow
- Owner: qwandor
- License: gpl-3.0
- Created: 2022-01-28T18:04:31.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-20T15:38:50.000Z (6 months ago)
- Last Synced: 2024-10-09T15:41:03.384Z (29 days ago)
- Topics: google-home, hacktoberfest, homie, mqtt, rust, smarthome
- Language: Rust
- Homepage:
- Size: 27 MB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# Homieflow
Homieflow is a gateway between Google Home and [devices](docs/homie.md) such as lights and
temperature sensors following the [Homie convention](https://homieiot.github.io/) defined on top of
MQTT.
This is not an officially supported Google product.
## Code organisation
The main modules and directories are:
### config/
Code for parsing the TOML configuration file.
### fulfillment/
Fulfillment service supports following intents
- Sync, get all available devices for a user.
- Query, used to check device state.
- Execute, used to execute some command on device, e.g turn on lights.
### oauth/
Handles OAuth2 requests from Google Home.
### extractors.rs
Axum extractors for things such as `RefreshToken` or `AccessToken`.
## License
Licensed under the GNU General Public License, Version 3 ([LICENSE](LICENSE) or https://www.gnu.org/licenses/gpl-3.0.en.html).
## Contributing
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the
work by you, shall be licensed as above, without any additional terms or conditions.
If you want to contribute to the project, see details of
[how we accept contributions](CONTRIBUTING.md).