alexa-youtube

Unofficial YouTube skill for Alexa

Update: 2 Dec 2024: This skill is no longer available due to changes in Youtube's API.

Sponsorship

• First things first, I am asking for $3/month to use this skill. You can test it for free, but it will only ever play Gangnam Style.
• You can donate through https://www.patreon.com/alexayoutube, or by clicking the Sponsor button at the top of this page. For just $3/month, I will give you a unique ARN which you can use to run this skill.
• Email me at [email protected] to receive your ARN. Let me know what country you are in, and I will make sure the server is close to you, which makes it respond slightly faster.

Features

• Play audio from YouTube videos
• Play video (if supported) on live videos or if you ask for just one specific video (command 8)

Launching

• In English, say "Alexa, launch YouTube".
• In German, say "Alexa, öffne YouTube".
• In Italian, say "Alexa, apri YouTube".
• In Spanish, say "Alexa, abrir YouTube".
• In French, say "Alexa, ouvre YouTube".

Skill Commands

1. Play a video, eg "Alexa, ask YouTube to play Gangnam Style"
2. Play a playlist, eg "Alexa, ask YouTube to play playlist Ultimate Beyonce"
3. Play a channel, eg "Alexa, ask YouTube to play channel Fall Out Boy Vevo"
4. You can replace "play" with "shuffle" to get a randomized version of the search results/channel/playlist, eg "Alexa, ask YouTube to shuffle channel Nicki Minaj"
5. Next / Previous / Start Over / Pause / Resume should all work
6. Ask what is playing by "Alexa, ask YouTube what song is playing" (or just "Alexa, can you repeat that?" should tell you)
7. Skip forward or back in the video by "Alexa, ask YouTube to skip forward/backward to/by one minute and one second"
8. Just play one video by "Alexa, ask YouTube to play one video Gangnam Style". You can switch in and out of "autoplay" mode by "Alexa, ask YouTube to turn on/off autoplay."
9. Find the current time in the video by "Alexa, ask YouTube what is the timestamp?"
10. If you want to play your own playlists, and the search feature finds other people's, send me a link to your youtube page.
11. Play related videos, by "Alexa, ask YouTube to play more like this". This is a YouTube feature, don't ask me why it plays what it plays.

Command 7 doesn't seem to work on Generation 1 Echo's, no idea why. Commands 8, 9, 10 and 11 are only available in English at the moment. Need them in your language? Drop me an email and we can figure out the translation.

Known issues

1. Some videos just fail, it's not clear why, they just do. The skill just moves to the next video on the playlist, but this can mean sometimes she announces a video that doesn't play.
2. It appears this skill only works on Amazon Echo products, not on 3rd party products that support Alexa. If you get it to work on another device, please let me know.
3. Live videos work on Gen 2 devices onwards, not on the original Gen 1 Echo.

Setup Instructions

1. Go to the Alexa Console (https://developer.amazon.com/alexa/console/ask)
2. If you have not registered as an Amazon Developer then you will need to do so. Fill in your details and ensure you answer "NO" for "Do you plan to monetize apps by charging for apps or selling in-app items" and "Do you plan to monetize apps by displaying ads from the Amazon Mobile Ad Network or Mobile Associates?"
3. Once you are logged into your account click "Create Skill" on the right hand side.
4. Give your skill any name, eg "My YouTube Skill".
5. Set the "Primary Locale" to whatever language your Echo device is set to. (If you are not sure, go to the Alexa app, go to Settings, Device Settings, then click on your Echo device, and look under Language.) Turn on "Sync Locales".
6. Choose "Custom" as your model, and "Provision Your Own" as your method, then click "Create Skill". On the template page, choose "Start from scratch".
7. On the left hand side, click the arrow next to "Interaction Model", then click "JSON Editor".
8. Delete everything in the text box, and copy in the text from here, (or French, Italian, German, Spanish, Japanese or Brazilian Portuguese.)
9. Click "Save Model" at the top.
10. Click "Interfaces" in the menu on the left, and enable "Audio Player" and "Video App". Click "Save Interfaces".
11. Click "Endpoint" in the menu on the left, and select "AWS Lambda ARN". Under "Default Region", put the ARN. You can get an ARN by sponsoring me on https://www.patreon.com/alexayoutube, or by clicking the Sponsor button at the top of this page. (If you would like to test the skill before sponsoring me, put arn:aws:lambda:eu-west-1:175548706300:function:YouTubeTest - but this will only play Gangnam Style.) Click "Save Endpoints".
12. Click "Tools" on the left, and then click "Permissions", and turn on "Lists Read" and "Lists Write".
13. Click "Custom" in the menu on the left, then click "Invocation Name" on the right hand side.
14. If you want to call the skill anything other than "youtube", change it here. Click "Save Model" if you change anything.
15. Click "Build Model". This will take a minute, be patient. It should tell you if it succeeded.
16. Important: At the top, click "Test". Where it says "Test is disabled for this skill", change the dropdown from "Off" to "Development".

FAQ

• Alexa tells me she can't find any supported video skills, what does that mean? Alexa is trying to be too clever, and not launching this skill. Start your request by saying 'Alexa, launch YouTube' and then when she says 'Welcome to YouTube', ask for the video you want.
• She still says she can't find any video skills. Make sure to follow step 19 above, enabling Testing for Development.
• She still says she can't find any video skills! Try using a different word to start the skill. In English, say "Alexa, launch YouTube". In German, say "Alexa, öffne YouTube". In Italian, say "Alexa, avvia YouTube". In Spanish, say "Alexa, abrir YouTube".
• I am getting another issue, can you fix it? Hopefully, drop me an email!
• If I try and test in the Developer Console, it says 'Unsupported Directive. AudioPlayer is currently an unsupported namespace. Check the device log for more information.' That is normal, the Developer Console doesn't play audio. You just need to enable testing through the Developer Console, then you can use the skill through your Alexa device.
• Why don't more videos work as video? Alexa doesn't provide any ability to enqueue videos, so you only get one video, then it stops. So it only plays videos if you ask for one specific video, or if it is a live video.
• Didn't the code used to be freely available? Yes, it did. Unfortunately people started stealing my code and taking credit for it, and asking for donations, so now the code is private.