Skip to content

Home Assistant integration for Spotify Player control, services, and soundtouchplus integration support.

License

Notifications You must be signed in to change notification settings

thlucas1/homeassistantcomponent_spotifyplus

Repository files navigation

SpotifyPlus

GitHub Release License docs hacs

Project Maintenance BuyMeCoffee

Home Assistant Integration to integrate with spotifyplus.
Extended support for the Spotify Connect media player for use in Home Assistant.

This integration will set up the following platforms.

Platform Description
media_player Media Player Entity.

Features

The following Home Assistant media_player Platform services are supplied by this integration.

  • BROWSE_MEDIA
  • MEDIA_ENQUEUE
  • NEXT_TRACK
  • PAUSE
  • PLAY
  • PLAY_MEDIA
  • PREVIOUS_TRACK
  • REPEAT_SET
  • SEEK
  • SELECT_SOURCE
  • SHUFFLE_SET
  • TURN_OFF
  • TURN_ON
  • VOLUME_MUTE
  • VOLUME_SET
  • VOLUME_STEP

Check out the Media Player Service Enhancements wiki page for detailed explanations and YAML examples of the media player service enhancements provided by this integration.

Custom Services

This integration provides 99% of the services offered by the Spotify Web API.
Check out the Services Provided wiki page for detailed explanations and YAML examples.

HACS Installation Instructions

  • go to HACS main menu.
  • click on the 3-dot overflow menu in the upper right, and select custom repositories item.
  • copy / paste https://github.com/thlucas1/homeassistantcomponent_spotifyplus in the Repository textbox and select Integration for the category entry.
  • click on Add to add the custom repository.
  • you can then click on the SpotifyPlus repository entry (you may need to filter your list first to find the new entry).
  • click on download to start the download. It will install the spotifyplus integration to your config/custom_components directory.
  • restart HA to start using the component.

Manual Installation

  • Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  • If you do not have a custom_components directory (folder) there, you need to create it.
  • In the custom_components directory (folder) create a new folder called spotifyplus.
  • Download all the files from the custom_components/spotifyplus/ directory (folder) in this repository.
  • Place the files you downloaded in the new directory (folder) you created.
  • Restart Home Assistant.
  • In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "SpotifyPlus"

Configuration

All configuration of the integration is done in the UI.

Advanced Logging Support

The SmartInspectPython package (installed with this integration) can be used to easily debug the integration. Note that the standard Home Assistant logger is also supported, but does not provide as much information as the SmartInspect logger.

Check out the SmartInspect Logging Configuration wiki page for more information on how to configure and enable / disable advanced logging.

Reporting a Problem

Submit a Bug Report to bring the issue to my attention. I receive a notification when a new issue is opened, and will do my best to address it in a prompt and professional manner.

Request a New Feature

Do you have an idea for a new feature that could be added to the integration? Submit a Feature Request to get your idea into the queue. I receive a notification when a new request is opened, and will do my best to turn your idea into the latest and greatest feature.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines