# alandtse/alexa_media_player

This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API.

Repository: https://github.com/alandtse/alexa_media_player
Canonical: https://ross.abutalabs.com/products/alexa_media_player
Language: Python
License: Apache-2.0
License Family: permissive
Topics: alexa, home-assistant, hacktoberfest, homeassistant
Last push: 2026-08-24T19:06:02+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 94, longevity 100
- inputs: {"age_days": 2982, "days_push": 9, "days_rel": 41, "gap_med": 6.0, "n_releases_24m": 59}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1971, forks 342 (observed 2026-08-28T04:06:00.911855+00:00)

## What it is
A Home Assistant custom component that controls Amazon Alexa/Echo devices through the unofficial Alexa API, exposing them as media player entities. It supports playback control, volume, and metadata retrieval, but relies on an unofficial API that Amazon could revoke at any time.

## Use cases
- control my Echo speakers from Home Assistant
- play and pause music on Alexa devices in automations
- show current song title and album art from Echo in my dashboard
- set volume on all my Alexa devices at once
- integrate Echo Dot as a media player entity
- automate Alexa announcements and playback via Home Assistant

## When to choose
- you run Home Assistant and own Amazon Echo/Alexa devices
- you want Echo devices as native media player entities with track metadata
- you need Alexa device control in HA automations without official Alexa integration limitations

## When to avoid
- you need a guaranteed, officially supported integration (Amazon may cut off the unofficial API)
- you don't use Home Assistant
- you need features beyond media playback control and metadata

## Facets
- artifact type: plugin
- maturity: active
- function: http-client, middleware
- domain: iot, self-hosted, apis
- platform: python, self-hosted
- tags: home-assistant, alexa, echo, media-player, custom-component, hacs, unofficial-api, smart-speaker, automation

## Member repositories
- alandtse/alexa_media_player (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:00.911855+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:05:04.267071+00:00, confidence not recorded.
  - readme: https://github.com/alandtse/alexa_media_player (fetched 2026-08-28T04:06:00.911855+00:00, sha ca94bd47b697)
- Data as of 2026-08-30T08:39:29.467469+00:00.