alexa_media_player is a free, open source internet of things (iot) project written in Python and released under Apache-2.0. It has 1,988 GitHub stars, 346 forks and 16 open issues, and was last pushed 12 hours ago. On this registry it ranks #43 of 79 tracked projects in Internet of Things (IoT), with 5 head-to-head comparisons available.

What is alexa_media_player?

Alexa Media Player is a custom Home Assistant component that lets people who own Amazon Echo devices control them as media players through the unofficial Alexa API.

What it is

Alexa Media Player is a Python custom component for the Home Assistant home-automation platform, distributed through the HACS integration repository and released under the Apache-2.0 licence. It lets Amazon Echo products appear and behave as Home Assistant media devices, so their playback and metadata become available to the rest of a Home Assistant installation alongside its other entities. The component mimics the behaviour of the Alexa app by speaking to the unofficial Alexa API.

The problem it solves is that Amazon Echo devices are otherwise closed off from Home Assistant: without this component there is no way to treat an Echo as a controllable media player or to surface what is playing on it inside Home Assistant. The README is explicit that the integration relies on an unofficial API that Amazon may cut off access at any time, so its continued operation is not guaranteed by Amazon.

Key capabilities

  • Play, pause and stop playback on Amazon Echo products exposed as Home Assistant media devices.
  • Skip to the next or previous track.
  • Adjust device volume.
  • Retrieve the song title for display inside Home Assistant.
  • Retrieve the artist's name and the album name of the current track.
  • Retrieve the album image for display alongside the other track metadata.
  • Contribute translations through the project's Lokalise project, with native speakers invited to join the team.

Who uses it and how

  • Home Assistant users who own Amazon Echo products and want those devices controllable as media players from their Home Assistant instance.
  • People contributing to the component's documentation, since the wiki is described as a group effort covering usage and useful automations.
  • Translators, who join the Lokalise team to localise the component's interface strings.
  • Contributors of all kinds, including those who do not write code: the README invites users to file bugs and feature requests and to answer questions in the repository and on the Home Assistant forums.
  • Testers, per the linked Home Assistant forum thread asking for Echo device and Alexa-as-media-player testers.

Getting started

Installation and configuration instructions are held in the project wiki rather than the README, so the recommended path is to follow the wiki's Configuration page; the component is available as a HACS default repository and additional documentation and automations live in the same wiki.

How it compares

This registry names no other projects in this category for Alexa or Home Assistant media playback, so Alexa Media Player stands alone here.

When to use it — and when not

Prospective users should understand the central risk stated in the README: the component depends on an unofficial API that mimics the Alexa app, and Amazon may cut off access at any time, so automations built on it can break without notice from this project. Anyone who needs a formally supported, stable integration for controlling Echo devices should not pick it, and people who are unwilling to read a separate wiki for configuration will find the README thin. On the plus side, the project is actively maintained with a recent last push, an Apache-2.0 licence, CI validation and semantic-release workflows, and 16 open issues indicate active but not overwhelming support demand.

project readme (upstream, from github) — read inline

Validate semantic_release hacs_badge GitHub all releases GitHub release (latest by SemVer)

Alexa Media Player Custom Component for homeassistant

What This Is:

This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API. Please note this mimics the Alexa app but Amazon may cut off access at anytime.

Originally inspired and created by Keaton Taylor

What It Does:

Allows for control of Amazon Echo products as home assistant media devices with the following features:

  • Play/Pause/Stop
  • Next/Previous (Track)
  • Volume
  • Retrieval for displaying in home assistant of:
    • Song Title
    • Artists Name
    • Album Name
    • Album Image

Installation and Configuration

Please see the wiki.

Further Documentation

Please see the wiki

Changelog

Please reference the release history.

How to Help

While it'd be nice to have more developers, you can contribute without knowing how to code. You can file bugs/feature requests, help answer questions here and on the HA forums, or you can help with other tasks like translations and updating the wiki.

Translations

We are now on Lokalise. If you're a native speaker, please join the team. See Translations page for more details.

Documentation

The wiki is a group effort to document how to use the component and other useful automations. Don't worry about making mistakes as we can revert using the history.

License

Apache-2.0. By providing a contribution, you agree the contribution is licensed under Apache-2.0. This is required for Home Assistant contributions.

Frequently asked questions

Is alexa_media_player free to use?

alexa_media_player is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does alexa_media_player do?

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

What is alexa_media_player written in?

alexa_media_player is primarily written in Python. Its source is publicly available at https://github.com/alandtse/alexa_media_player, and it has 1,988 GitHub stars.