ottosichert / alexa-soundcloud

🗣🎶☁️ Play any stream from SoundCloud on Alexa
https://alexa-soundcloud.now.sh
MIT License
2 stars 0 forks source link
alexa now rss soundcloud zeit

alexa-soundcloud

This public endpoint allows playing music from SoundCloud via a generated RSS feed. This endpoint acts as an convenience wrapper around SoundCloud's public API linked below. It works by calling the same URL path after https://alexa-soundcloud.now.sh appended to https://api.soundcloud.com.

This is with the exception of https://alexa-soundcloud.now.sh/stream/<track_id> which resolves a track ID to a temporary playable URL using the SoundCloud internal API (https://api-v2.soundcloud.com).

Installation

Enable any Alexa skill capable of playing music from RSS. I found https://mypodapp.com which has a minimal but ad-free option for users.

SoundCloud API

The documentation of SoundCloud's public API (not the https://api-v2.soundcloud.com used on the live site) can be found here: https://developers.soundcloud.com/docs/api/guide

To get your SoundCloud client_id log in and go to https://soundcloud.com/stream and check the network tab of your developer tools for any requests containing the client_id as HTTP GET query parameter.

alexa-soundcloud API

Additional options can be passed as HTTP Basic authentication username in form of a query string, e.g.:

simple=foo&shorthand&nested.key=bar
Name Usage Description
shuffle shuffle Set to any value to randomly shuffle the output after retrieving the desired list
relative relative.created.to=P10Y Today's date subtracted of the duration parsed by ISO 8601 will be added to the key path after relative

Examples