About
Alexa Media Player controls Amazon Alexa devices from Home Assistant through the unofficial Alexa API. Echo devices appear as media players with play, pause, stop, track skipping and volume, and the current song title, artist, album and cover image are shown. It also adds sensors such as temperature, air quality, humidity, next alarm, next reminder and next timer, plus switches for do not disturb, repeat and shuffle. Other platforms include alarms, lights, notifiers and selects, and actions cover Amazon Kids mode, restoring the previous volume, fetching history records and rediscovering the Alexa network. It needs Amazon's cloud, is set up in the UI with Amazon account sign-in and region, and has options for polling interval, device filters and one-time password or authenticator key. Because it mimics the Alexa app, Amazon may cut off access at any time.
Automatic summary of the README and code of alandtse/alexa_media_player. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Lights
- Alarms
- Media
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Connect
- Advanced debugEnables very verbose, trace-level logging for advanced troubleshooting. Not recommended for normal operation due to increased log volume. Ensure logger levels are set to DEBUG for full output.
- Email Address
- or Exclude these devices from all (comma separated)
- Include additional sensors, switches and lights
- Local network URL to access Home Assistant
- Only include these devices (comma separated)
- 52-character Authenticator App Key for Amazon 2SVExample: 35T5 LQSY I5IO 3EFQ LGAJ I6YB JWBY JJPR PYT7 XPPW IDAK SQBJ CVXA
- Password
- Public URL shared with external hosted services
- Delay to queue multiple commands together (seconds)
- Scheduled polling interval (seconds)
- One-time password (OTP)
- Discover Alexa network
- Amazon region domain (e.g., amazon.co.uk)
Alexa Media Player - Amazon Region Mismatch
- Change configuration to the Amazon-reported region
Alexa Media Player - Unable to Connect to HA URL
- Ignore and Continue - I understand that no support for login issues are provided for bypassing this warning.
Alexa Media Player - OTP Confirmation
- Yes, OTP code was verified
After setup
- Advanced debugEnables very verbose, trace-level logging for advanced troubleshooting. Not recommended for normal operation due to increased log volume. Ensure logger levels are set to DEBUG for full output.
- or Exclude these devices from all (comma separated)
- Include additional sensors, switches and lights
- Only include these devices (comma separated)
- 52-character Authenticator App Key for Amazon 2SVExample: 35T5 LQSY I5IO 3EFQ LGAJ I6YB JWBY JJPR PYT7 XPPW IDAK SQBJ CVXA
- Public URL shared with external hosted services
- Delay to queue multiple commands together (seconds)
- Scheduled polling interval (seconds)
- Discover Alexa network
Texts from the code of alandtse/alexa_media_player.
Entities
- SensorsAir quality, Carbon monoxide, Humidity, Indoor air quality, Particulate matter, Volatile organic compounds, Next alarm, Next reminder, Next timer, Temperature
- SwitchesDo not disturb, Repeat, Shuffle
Actions
- Disable Amazon KidsTurns off Amazon Kids (child mode) for an Echo by unassigning it from any child profile.Fields: Select media player:
- Enable Amazon KidsTurns on Amazon Kids (child mode) for an Echo by assigning it to a child profile.Fields: Child, Select media player:
- Enable Network DiscoveryRe-enables Alexa network discovery so the next polling cycle will rediscover Alexa devices for the selected accounts.Fields: Email address
- Force LogoutForce account to logout. Used mainly for debugging.Fields: Email address
- Get History RecordsParses the history records for the specified deviceFields: Select media player:, Number of entries
- Restore Previous VolumeRestore previous volume level on Alexa media player deviceFields: Select media player:
- Update Last Called SensorForces update of last_called echo device for each Alexa account.Fields: Email address
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:YAML configuration is deprecated
From the README
Alexa Media Player Custom Component for homeassistant
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.
- Play/Pause/Stop
- Next/Previous (Track)
- Volume
- Retrieval for displaying in home assistant of:
- Song Title
- Artists Name
- Album Name
- Album Image
Shows in Vulpo
Light card, Quick Toggle card, Media Player card, Alarm Panel card, Apple Watch, Control Center.Information
- Installs
- 29.9k sharing analytics
- GitHub stars
- 2k
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v5.18.0,
- Category
- AI and voice, Voice assistants
- Kind
- Marketplace integration
- Brand
- Amazon
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
alexa_media- Issues
- Report an issue
















