Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lab02-research/hass.agent-mediaplayer

HASS.Agent MediaPlayer integrations. Adds TTS and the ability to control local media to HASS.Agent - a Windows based client for Home Assistant.
https://github.com/lab02-research/hass.agent-mediaplayer

hacs home-assistant integration mediaplayer

Last synced: 2 days ago
JSON representation

HASS.Agent MediaPlayer integrations. Adds TTS and the ability to control local media to HASS.Agent - a Windows based client for Home Assistant.

Awesome Lists containing this project

README

        

[![Validate](https://github.com/LAB02-Research/HASS.Agent-MediaPlayer/workflows/Validate/badge.svg)](https://github.com/LAB02-Research/HASS.Agent-MediaPlayer/actions?query=workflow:"Validate")
[![GitHub release](https://img.shields.io/github/release/LAB02-Research/HASS.Agent-MediaPlayer?include_prereleases=&sort=semver&color=blue)](https://github.com/LAB02-Research/HASS.Agent-MediaPlayer/releases/)
[![License](https://img.shields.io/badge/License-MIT-blue)](#license)
[![buymeacoffee](https://img.shields.io/badge/BuyMeACoffee-Donate-blue.svg)](https://www.buymeacoffee.com/lab02research)
[![Discord](https://img.shields.io/badge/dynamic/json?color=blue&label=Discord&logo=discord&logoColor=white&query=presence_count&suffix=%20Online&url=https://discordapp.com/api/guilds/932957721622360074/widget.json)](https://discord.gg/nMvqzwrVBU)

[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)

# HASS.Agent MediaPlayer

⚠️❗**YOU DON'T NEED THIS INTEGRATION IF YOU'RE USING THE NEW [HASS.AGENT](https://github.com/LAB02-Research/HASS.Agent-Integration) INTEGRATION!** ❗⚠️

----

Note: this integrations has been replaced by the [new integration](https://github.com/LAB02-Research/HASS.Agent-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](https://hassagent.readthedocs.io/), 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](https://github.com/LAB02-Research/HASS.Agent/releases/tag/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](#functionality)
* [Installation](#installation)
* [Configuration](#configuration)
* [Debugging](#debugging)
* [License](#license)

----

### 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](https://user-images.githubusercontent.com/81011038/165733600-0cb95d3c-ae18-4811-82de-80770974146f.png)

----

### 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](https://hassagent.readthedocs.io/en/latest/mediaplayer/mediaplayer-usage-and-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:

```yaml
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](https://raw.githubusercontent.com/LAB02-Research/HASS.Agent/main/images/mediaplayer_debug_logging.png)

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

----

### License

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