Skip to content

c0un7-z3r0/hass-phoniebox

Repository files navigation

HA Phoniebox

GitHub Release GitHub commit activity License hacs Project Maintenance Project Maintenance Validate

Component to integrate your phoniebox with Home Assistant.

ha phoniebox mediaplayer

Features:

  • add one or multiple phonieboxes as device to your home assistant
  • media_player integration
  • many sensors that are exposed via mqtt from phoniebox can be used
  • enable / disable rfid or gpio from home assistant as configuration
  • switch to toggle mute or random

Overview of what Features of Phoniebox have been implemented can be found in the issues.

How does it work

Once the custom component is installed you can add your phoniebox as device in home assistant. You can name your phoniebox and configure the MQTT base topic in case you have multiple phonieboxes.

All communication with Phoniebox is running over MQTT.

Requirements

Installation

Install via HACS

  1. Open HACS and go to integrations
  2. In the top right corner, click on the 3 dots and select Custom repositories
  3. Add this repo URL https://github.com/c0un7-z3r0/hass-phoniebox and select Integration as category.
  4. Back in HACS->Integrations click on Explore & Download Repositories in the bottom right corner
  5. search for phoniebox and download the repository
  6. Restart Home Assistant

Manual Install

If you want to install the custom component manually, add the folder phoniebox/ to YOUR_CONFIG_DIR/custom_components/.

Configuration is done in the UI

  1. Once installed you can add your phoniebox as new device in Home Assistant
  2. Go to Configuration -> Devices & Service
  3. Add the phoniebox integration via the button in the bottom right

There are currently two settings that need configuration for the phoniebox. The name of the phoniebox and the base MQTT Topic. This helps if you have multiple phonieboxes that you want to add to Home Assistant.

ha phoniebox config

ha phoniebox integration

Issues

If When you experience issues/bugs with this the best way to report them is to open an issue in this repo.

Report issues here

Contributions are welcome!