Skip to content

Latest commit

 

History

History
94 lines (53 loc) · 4.76 KB

README.md

File metadata and controls

94 lines (53 loc) · 4.76 KB
Raw

Validate GitHub release License buymeacoffee Discord

hacs_badge

HASS.Agent MediaPlayer

⚠️❗YOU DON'T NEED THIS INTEGRATION IF YOU'RE USING THE NEW HASS.AGENT INTEGRATION! ❗⚠️

Note: this integrations has been replaced by the new integration. It will keep working, but for new functionality, consider switching to the new one.

This Home Assistant integration allows you to use your HASS.Agent (a Windows-based Home Assistant client) as a mediaplayer device: see and control what's playing and send text-to-speech!

Need help? Check the documentation, visit the dedicated HA forum thread or join on Discord.

Note: it won't be of much use if you don't have HASS.Agent installed & configured on at least one PC (or Windows based device).

HASS.Agent release 2022.12.0 or higher is required to actually use this.

IMPORTANT: Only install the latest release if you're on Home Assistant 2022.5 or higher! If you're running an ealier release, use release 2022.4.21 of the integration.

Contents

Functionality

You can control your PC as if it were a regular mediaplayer, regardless of what application is actually playing. Control volume, next/previous, stop, play/pause and volume. If the application supports it, you'll be able to see what's currently playing.

As a bonus, you can use your PC as a text-to-speech target.

image

Installation

The easiest way to install is to use HACS. Simply search for HASS.Agent MediaPlayer, install and restart Home Assistant.

If you want to manually install, copy the hass_agent_mediaplayer folder into the config\custom_components folder of your Home Assistant instance, and restart.

Configuration

Please consult the documentation for more info on configuring and using this integration: MediaPlayer Usage & Examples

Debugging

If something's not working as it should, while everything's configured and HASS.Agent isn't showing any errors in its logs, browse to the following URL from another PC on the same network as HASS.Agent: http://{hass_agent_ip}:5115. Make sure to change {hass_agent_ip} to the IP of the PC where HASS.Agent's installed.

If HASS.Agent is configured and the firewall rule's active, you'll see: HASS.Agent Active.

If not, something is blocking access to HASS.Agent. Add the following snippet to your configuration.yaml to enable debug logging for the integration:

logger:
  default: warning
  logs:
    custom_components.hass_agent_mediaplayer: debug

Reboot Home Assistant. Whenever you control the mediaplayer entity or send text-to-speech, this should show up in your logs:

Debug Output

If not, please open a ticket and post your log output.

License

HASS.Agent Notifier and HASS.Agent are released under the MIT license.