Alexa Media Player
alandtse/alexa_media_player · vv5.18.0
This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
media_player | TV, receiver or media switches | Needs its own HomeKit Bridge in accessory mode |
alarm_control_panel | Security system | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
select | Mode picker (as switches) |
What people report
Echo devices are controlled via Amazon's cloud, so no local playback of custom MP3s and login/2FA setup is a frequent pain. New Echo models are added quickly.
- Works7
- Partly works2
- Won’t be supported1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Amazon Air Quality Monitor | Works Cloud | Entities including TVOC appear via Alexa Media Player integrationSaved copyFor those interested in TVOC, the Amazon Air Quality Monitor uses a SEN44 that I think is the same as the SEN54, the difference being that Sensirion won't issue a data sheet for the SEN44 as it is not a retail product. Looks the same. The Amazon entities, including TVOC, are revealed in HA using the "Alexa Media Player" integration listed under HACS. They don't show as devices as they piggy-back on the Echo devices, so prepare to be mystified. Sensiron publish their methodology for TVOC data analysis, referencing current values to a moving average of all data over the previous 24 hours on a … Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2023-03 | |
| Amazon Echo Dot | Works Cloud | TTS and sound library playback in HA; notifications quick without lagSaved copyI have Amazon Echo Dots in each room and they are accessible to HA using the Alexa Media Player integration which I think came from HACS. It can use Text to speech (TTS) to make the Echo Dots say anything I want. It can also make the Echo Dots play any sound in the Alexa Audio Library which includes various dog barking recordings. I believe there is a way to have them play custom mp3 files but I haven’t tried that out. The Amazon Echo Dots require internet connectivity to work so be aware of that. Just my 2 cents for what you are looking for. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2023-12 | |
| Amazon Indoor Air Quality Monitor | Works Cloud | Now a device grouping air quality and temperature sensorsSaved copyIntroduce a Home Assistant device to represent the Amazon Indoor Air Quality Monitor (AIAQM) device - Group all AIAQM-related entities (air quality sensors and temperature) under this device - Replace previously unattached AIAQM entities with a properly grouped device representation - Preserve existing entity IDs and behavior for non-AIAQM devices - Filter AIAQM sub-sensors using asset-based friendly names to avoid exposing unsupported capabilities (e.g. PM10: "@type : text") - No new services, controls, or configuration options added Amazon’s _Indoor Air Quality Monitor_ reports multiple … Excerpt saved from GitHub on 2026-10-23. | PR #3314 · 2026-01 | |
| Denon Home 150 | Works Cloud | Support addedSaved copyInspired by #3378 I added two of my Denon devices. One limitation: I dont have a Denon Home 350, so don't know what the identifier of that one is. ## Summary by CodeRabbit * New Features * Added support for Denon Home 150 and Denon Home 250 speakers, discoverable, status shown, and controllable from the app. * Other * Updated device naming for a Fire TV entry to "Fire TV Stick 4K Max (Gen1)" for clearer identification. Excerpt saved from GitHub on 2026-10-23. | PR #3381 · 2026-02 | |
| Denon Home 250 | Works Cloud | Support addedSaved copyInspired by #3378 I added two of my Denon devices. One limitation: I dont have a Denon Home 350, so don't know what the identifier of that one is. ## Summary by CodeRabbit * New Features * Added support for Denon Home 150 and Denon Home 250 speakers, discoverable, status shown, and controllable from the app. * Other * Updated device naming for a Fire TV entry to "Fire TV Stick 4K Max (Gen1)" for clearer identification. Excerpt saved from GitHub on 2026-10-23. | PR #3381 · 2026-02 | |
| Echo Show 11 (Gen1) | Works Cloud | Added to device listSaved copySummary by CodeRabbit * Bug Fixes * Added support for Echo Show 11 (Gen1) device in Alexa Media component. Excerpt saved from GitHub on 2026-10-23. | PR #3378 · 2026-02 | |
| Echo Show 8 (Gen4) | Works Cloud | Device type addedSaved copyAdds the device type for the 2025 Echo Show 8 (4th gen, model MD6NE4, the Alexa+ model with spatial audio) to `MODEL_IDS`, so it shows as "Echo Show 8 (Gen4)" instead of the raw family and type (`KNIGHT A345JHMQDGG1M5`). Tested on my own device: it reports device type `A345JHMQDGG1M5`, and the sticker model number is MD6NE4. ## Summary by CodeRabbit - New Features - Added support for identifying the Echo Show 8 (4th Generation) device. Excerpt saved from GitHub on 2026-10-23. | PR #3635 · 2026-10 | |
| Alexa Media Player (Echo devices) | Partly works | Music can be played to Echo; multiroom sync with TV audio has delaySaved copyHow to? Create a multiroom audio system using echo devices that takes input from my home theater system. I am in the process of moving everything over to home assistant and and am currently working on my home theater setup. I have Sonos or Bose wireless system on my short list of things to buy, but I already have so many devices and wanted to see if I could get something to work in the meantime. I currently have HA running on a NUC, an Nvidia Shield, an LGC1 oled tv, a PS5, and a Samsung Q950A soundbar system in my livingroom. Q950A is pretty decent and connected to the tv via eARC, so any … Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit thread · 2023-12 | |
| Echo Dot custom MP3 playback | Partly works Cloud | Direct music streaming unsupported; needs public HTTPS audioSaved copy… there! I got past the "500 Internal Service" error and I have an automation set up to play a sound effect when a specific trigger is enabled. Now - my Echo Dot is complaining that "Direct Music Streaming Isn't Supported", something that is set by Amazon, and not my AMP or HA. I'm attempting to play a sound effect, about 7 sec long. My "type" is set to music. If I change the type to "sound", I do not get an error, but the sound never plays, either. In my config, I've tried just the filename.mp3, then doing local/filename.mp3, and finally, the entire path, … Excerpt saved from GitHub on 2026-10-23. | Discussion #2774 · 2024-12 | |
| Echo devices with Home Assistant Radio Browser | Won’t be supported Cloud | Echo connects to Amazon cloud, so HA radio streams can't playSaved copyNo, the Home Assistant Radio browser streams from the cloud through Home Assistant to locally connected media players and Echo media players are connected to Amazon cloud, not Home Assistant. Echo media players can only stream from cloud services via skills in Amazon like Spotify, Tune-In, etc. Alexa Media Player is emulating an Alexa app so if the Alexa app can't do it, AMP can't either. Think of it as the AMP Echo media players are remote controlling the Echo through Amazon cloud like the app does. Excerpt saved from GitHub on 2026-10-23. | Discussion #3477 · 2026-05 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Cloud polling
Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.
Details
| Installs (analytics) | 30,011 (4.24%) |
|---|---|
| GitHub stars | 1,991 |
| Latest version | v5.18.0 (2026-10-22) |
| Set up in the UI | Yes |
| Maintainers | @alandtse, @keatontaylor |
| License | Apache-2.0 |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| keatontaylor/alexa_media_player | ★ 17 | 2023-11-28 | This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API. |
| nao-pon/alexa_media_player | ★ 3 | 2026-02-15 | This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API. |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/alandtse/alexa_media_player/wiki
- Source code: https://github.com/alandtse/alexa_media_player
- Issues: https://github.com/alandtse/alexa_media_player/issues
- HACS: https://hacs.xyz