This project provides Home Assistant blueprints and scripts to enable voice control for music playback via Music Assistant, bridging a gap in Home Assistant's native media intent capabilities. It targets Home Assistant users seeking to initiate music playback through voice commands, offering a community-driven solution to enhance smart home audio control.

How It Works

The project offers three distinct approaches. Option 1, the Local Assistant Blueprint, uses pure local intent handling with custom sentences for privacy-conscious users, though it requires precise command phrasing. Option 2, LLM-enhanced Local Assist, integrates with Home Assistant's LLM Conversation Agents (like OpenAI or Gemini) for more flexible voice interpretation, requiring an LLM setup and careful configuration to avoid conflicts. Option 3 provides a script designed to be used as a tool by LLMs, allowing for natural language commands where the LLM interprets the request and calls the script with structured parameters, offering the highest flexibility but relying heavily on the LLM's understanding.

Quick Start & Requirements

• Primary setup involves importing provided Home Assistant blueprints or scripts.
• Prerequisites include Home Assistant and Music Assistant installations. Options 2 and 3 require an LLM integration (e.g., OpenAI, Google Gemini) configured within Home Assistant.
• Setup time and resource footprint are dependent on the user's existing Home Assistant and LLM infrastructure.
• Links to import buttons for blueprints are provided within the README for various languages.

Highlighted Details

• A community-driven effort focused on enhancing voice control for music playback.
• Provides tiered solutions from fully local processing to advanced LLM integration.
• Supports multiple languages through dedicated blueprints and translation capabilities.
• Detailed examples and usage instructions are available for each option.

Maintenance & Community

• This is a community-driven effort, actively seeking contributions via Pull Requests and maintainer additions.
• No formal community channels (like Discord/Slack) or explicit roadmap are detailed in the provided text.

Licensing & Compatibility

• The license type and any compatibility notes for commercial use or closed-source linking are not specified in the provided README.

Limitations & Caveats

• The local-only option (Option 1) requires strict adherence to specific sentence structures.
• LLM-integrated options (Options 2 & 3) depend on the quality and configuration of the user's LLM integration, potentially leading to misinterpretations or requests for clarification.
• Option 2 may encounter errors if the LLM has unintended home control enabled, and precise entity naming is crucial if names are not exposed to the LLM.