[![Validate](https://github.com/alandtse/alexa_media_player/actions/workflows/validate.yaml/badge.svg)](https://github.com/alandtse/alexa_media_player/actions/workflows/validate.yaml)
![semantic_release](https://github.com/alandtse/alexa_media_player/workflows/semantic_release/badge.svg)
[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/hacs/integration)
![GitHub all releases](https://img.shields.io/github/downloads/alandtse/alexa_media_player/total)
![GitHub release (latest by SemVer)](https://img.shields.io/github/downloads/alandtse/alexa_media_player/latest/total)

[Alexa Media Player Custom Component](https://github.com/alandtse/alexa_media_player) for homeassistant

# What This Is:

This is a custom component to allow control of Amazon Alexa devices in [Home Assistant](https://home-assistant.io) 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](https://github.com/keatontaylor)

# 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.](https://github.com/alandtse/alexa_media_player/wiki/Configuration)

# Further Documentation

Please see the [wiki](https://github.com/alandtse/alexa_media_player/wiki)

# Changelog

Please reference the [release history](https://github.com/alandtse/alexa_media_player/releases).

# 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](https://github.com/alandtse/alexa_media_player/issues), help answer questions here and on the HA [forums](https://community.home-assistant.io/t/echo-devices-alexa-as-media-player-testers-needed/58639), or you can help with other tasks like [translations](##translations) and updating the [wiki](https://github.com/alandtse/alexa_media_player/wiki).

## Translations

We are now on [Lokalise](https://app.lokalise.com/project/465185555eee18dd537ca6.39714580/). If you're a native speaker, please [join the team](https://app.lokalise.com/public/465185555eee18dd537ca6.39714580/). See [Translations page](https://github.com/alandtse/alexa_media_player/wiki/Translations) for more details.

## Documentation

The [wiki](https://github.com/alandtse/alexa_media_player/wiki) is a group effort to document how to use the component and other useful [automations](https://github.com/alandtse/alexa_media_player/wiki/Examples%3A-Automation). Don't worry about making mistakes as we can revert using the history.

# License

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