Companion Media Player for Home Assistant (Marketplace integration)

Installs: 126 sharing analytics
GitHub stars: 8
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 0.2.2, October 26, 2026
Category: Media and entertainment
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: companion_media_player
Source: github.com/echocat/ha-companion-media-player
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Companion Media Player creates media player entities from the Android Companion App's Media Session sensors. It finds Android devices that have the Media Session sensor enabled and adds a media player for each one, working locally. Controls cover play, pause, stop, next and previous track, and volume, sent as notification commands through the Companion App. When a device has several active media sessions, such as Spotify and YouTube, they appear as selectable sources. Because the sensor only reports changes, the integration keeps a cache of session states and marks sessions inactive after a configurable timeout. It works with Android only and is set up in the UI.

Automatic summary of the README and code of echocat/ha-companion-media-player. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Media

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

After setup

Session timeout (minutes)

Texts from the code of echocat/ha-companion-media-player.

Entities

MediaMedia Player

From the README

A Home Assistant custom integration that creates Media Player entities from the Android Companion App's Media Session sensors.
Auto-Discovery: Automatically detects all Android devices with the Companion App that have a Media Session sensor enabled.
Full Media Player Controls: Play, Pause, Stop, Next Track, Previous Track, and Volume control — all sent via the Companion App's notification commands.
Multi-Session Support: Each Android device can have multiple active media sessions (e.g., Spotify, YouTube). Sessions are exposed as selectable sources.
State Caching: Since the Media Session sensor only reports state changes (not current state on demand), this integration maintains a persistent cache of all session states.
Session Timeout: Sessions that haven't reported activity within a configurable timeout (default: 30 minutes) are automatically marked as inactive.
Sensor Update Trigger: After every control command, a sensor update is triggered on the device to get faster state feedback.

From the README of echocat/ha-companion-media-player, Apache License 2.0. Shortened.