Skip to content

Latest commit

 

History

History
64 lines (45 loc) · 3.16 KB

README.md

File metadata and controls

64 lines (45 loc) · 3.16 KB
Raw

squeeze-alexa

Build Status Coverage Status Join the chat at https://gitter.im/squeeze-alexa/Lobby

squeeze-alexa is an Amazon Alexa Skill integrating with the Logitech Media Server ("squeezebox"). See the original announcement blog post, and the follow-up with videos.

This is still in beta, so feedback and help with documenting welcome - please just raise an issue first.

Aims

  • Intuitive voice control over common music scenarios
  • Low latency (given that it's a cloud service), i.e. fast at reacting to your commands.
  • Decent security, remaining under your own control
  • Extensive support for choosing songs by (multiple) genres, and playlists
  • Helpful, conversational responses / interaction.

Things it is not

  • Full coverage of all LMS features, plugins or use cases - but it aims to be good at what it does.
  • A public / multi-user skill. This means you will need Alexa and AWS developer accounts.
  • A native LMS (Squeezeserver) plugin. So whilst this would be cool, at least there's no need to touch your LMS.
  • Easy to set up 😱

Controlling your music

These should all work (usually) in the current version. Most commands can take a player name, or will remember the default / last player if not specified.

Playback

  • Alexa, tell Squeezebox to play / pause (or just Alexa, play / pause!)
  • Alexa, tell Squeezebox next / previous (or just Alexa, next / previous!)
  • Alexa, tell Squeezebox to skip (or just Alexa, skip!)
  • Alexa, tell Squeezebox to turn shuffle on / off (or just Alexa, Shuffle On/Off)

Control

  • Alexa, tell Squeezebox to select the Bedroom player
  • Alexa, tell Squeezebox to turn it down in the Living Room
  • Alexa, ask Squeezebox to pump it up!
  • Alexa, tell Squeezebox to turn everything off

Selecting Music

  • Alexa, tell Squeezebox to play some Blues and some Jazz
  • Alexa, tell Squeezebox to play a mix of Jungle, Dubstep and Hip-Hop
  • Alexa, ask Squeezebox to play my Sunday Morning playlist
  • Alexa, tell Squeezebox to play the Bad-Ass Metal playlist!

Feedback

  • Alexa, ask Squeezebox what's playing [in the Kitchen]

I want!

See the HOWTO for the full details of installing and configuring your own squeeze-alexa instance, or TROUBLESHOOTING if you're getting stuck.

Contributing

squeeze-alexa is an open source project licensed under GPLv3 (or later). If you'd like to help test, translate, or develop it, see the Github issues and read CONTRIBUTING.