FAQ

FAQ and common errors

idna.core.InvalidCodepoint: Codepoint U+201C at position 1 of '“amazon' not allowed

You copy and pasted the configuration values with a "smart" quotation which is unsupported. Remove or change the quotations in the configuration.

TTS doesn't support my language. (e.g., Spanish).

Amazon may not have enabled this. Please review this list for known supported languages. Does your mobile app work with the language? If not, it's probably Amazon.

Sorry, text to speech cannot be read with the alexa tts media player service

Don't use the media player UI. You need to use media_player.alexa_tts. If you can code, you can also fix the Media player UI. You can of course use the Lovelace custom-card, Mini Media Player to get it working in lovelace.

Alexa suddenly stopped working. It was working for a few months.

The login cookie may have expired. Delete your alexa_media.pickle from your configuration directory and restart HA. If you're uncomfortable deleting it, rename it to alexa_media.pickle.old so you can restore it.

urllib3.exceptions.NewConnectionError: <urllib3.connection.VerifiedHTTPSConnection object at 0x7010b490>: Failed to establish a new connection: [Errno -3] Try again

urllib3.exceptions.MaxRetryError: HTTPSConnectionPool(host='alexa.amazon.com', port=443): Max retries exceeded with url: /api/devices-v2/device (Caused by NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection object at 0x7010b490>: Failed to establish a new connection: [Errno -3] Try again',))

requests.exceptions.ConnectionError: HTTPSConnectionPool(host='alexa.amazon.com', port=443): Max retries exceeded with url: /api/devices-v2/device (Caused by NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection object at 0x7010b490>: Failed to establish a new connection: [Errno -3] Try again',))

Reboot. Connection pool issues are deeper issues for HA.

How do I enable debug logging for the component?

To turn on DEBUG mode, you’d need to edit your configuration.yaml:

logger:
  logs:
    custom_components.media_player.alexa: debug

How do I enable advanced debugging?

The component can also capture the various Amazon webpages it is processing. This may be helpful to debug issues logging in as it will provide the raw html of the webpages. This is done by enabling debug in the component configuration. Please note, Amazon pages may store login credentials in the html, so be careful sharing these files without scrubbing. Also, this debug functionality may change between versions depending on the last issue debugged.

media_player:
  - platform: alexa
    email: your amazon email
    password: your amazon password
    url: amazon.com
    debug: True

This will generate two debug files in the configuration directory.

• alexa_mediaget.html - This will show the initial form where the credentials will be input.
• alexa_mediapost.html - This is the webpage immediately after submitting login credential data via a post. This will often show Amazon's response indicating a need for 2FA or a captcha.

My question or issue isn't here!

Search the community thread and put the answer here or file an issue if it's new.