Welcome to UbiHome!

UbiHome is a single executable that allows you to integrate any device running an OS into your smart home. It is designed to be lightweight and easy to use - similar to ESPHome.

• Execute a command on a device based on a trigger in home assistant.
• Monitor the status of a device with a custom command.
• Integrate all of your one off python scripts^TM without thinking about connectivity or setting up yet another service.

See the getting started guide for installation instructions.

Explore the examples to see how to use UbiHome.

pi@raspberrypi:~/ $ ubihome
UbiHome - 0.14.0

UbiHome is a system which allows you to integrate any device running an OS into your smart home.
https://github.com/UbiHome/UbiHome

Usage: ubihome [OPTIONS] <COMMAND>

Commands:
  install    Install UbiHome
  uninstall  Uninstall UbiHome
  run        Run UbiHome manually.
  help       Print this message or the help of the given subcommand(s)

Options:
  -c, --configuration <configuration_file>
          Optional configuration file. If not provided, the default configuration will be used. [default: config.yaml]
  -h, --help
          Print help
  -V, --version
          Print version

Roadmap

• Monitor connected bluetooth devices and maybe even proxy them to home assistant.
• Auto installation
• Templates and Services
• Additional Components:
• HTTP and Web Enpoint
• BLE (https://github.com/deviceplug/btleplug)
• Bluetooth Proxy (https://esphome.io/components/bluetooth_proxy.html) https://docs.rs/bluer/latest/bluer/
• Online Sensor
• Custom compilation for modular builds and custom extensions.
• CLI for automatic generation of executables
• Builder Component similar to ESP Home
• Kernel events (e.g. Keyboard press) https://docs.rs/evdev/latest/evdev/
• Windows Current User https://docs.rs/wmi/latest/wmi/

... Control USB Devices?

Add Badges? https://github.com/squidfunk/mkdocs-material/discussions/7137