explaingit

bwilky/ha-spotify-browser

Analysis updated 2026-05-18

50JavaScriptAudience · generalComplexity · 2/5Setup · moderate

TLDR

A dashboard card that lets Home Assistant users browse, search, and control Spotify playback without leaving their home automation interface.

Mindmap

mindmap
  root((repo))
    What it does
      Browse Spotify
      Control playback
      Dashboard card
    Tech stack
      JavaScript
      YAML
      Home Assistant
    Use cases
      Multi account households
      Wall tablet dashboards
      Queue sidebar
    Audience
      Home automation hobbyists
      Smart home tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Browse and play Spotify playlists and albums directly from a Home Assistant dashboard on a tablet or wall panel.

USE CASE 2

Give each household member their own Spotify account switcher on a shared dashboard.

USE CASE 3

Show a queue sidebar and miniplayer with just the playback controls you want visible.

What is it built with?

JavaScriptYAMLHome AssistantHACS

How does it compare?

bwilky/ha-spotify-browserowenyuwono/poseidongangweix/next-forcing
Stars505051
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderatehard
Complexity2/54/55/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the separate Spotify Plus companion component to already be set up.

In plain English

Spotify Browser Card is a custom dashboard card for Home Assistant, the open source home automation platform. It lets you browse, search, and control playback on your Spotify account from any connected device, directly inside your Home Assistant dashboard, instead of switching over to the Spotify app. This card is not a standalone player. It depends on a separate companion piece called Spotify Plus, which handles the actual connection to the Spotify service. The card itself is the visual browsing and control layer that sits on top of that connection. You can set up multiple Spotify accounts on the same dashboard, which is useful if several people in a household each have their own account, and switch between them with named labels and optional shortcut links. There is a queue sidebar you can open on the desktop view, and a miniplayer with buttons you can turn on or off individually, such as shuffle, previous, next, like, volume, and device selection. You can also choose which playback devices show up in the interface and which stay hidden, and pick a default device to select automatically. The card supports an optional integration with Last.fm for a similar artists feature and for generating radio based on a track, using your own Last.fm API key. There is a performance mode that turns off background blur and transparency effects, meant for older tablets that might struggle to render them smoothly. Installation goes through HACS, the standard tool for adding third party components to Home Assistant, or manually by copying the JavaScript file into your setup. Configuration is written in YAML. The project's author notes it is new and still likely to have bugs, and welcomes bug reports and feature requests.

Copy-paste prompts

Prompt 1
Help me install the Spotify Browser Card for Home Assistant using HACS and connect it to my Spotify Plus entity.
Prompt 2
Write a Lovelace YAML config for Spotify Browser Card with two Spotify accounts and a queue sidebar enabled.
Prompt 3
Configure performance mode in Spotify Browser Card so it runs smoothly on an older wall mounted tablet.
Prompt 4
Set up Last.fm similar artists and radio generation in my Spotify Browser Card config.

Frequently asked questions

What is ha-spotify-browser?

A dashboard card that lets Home Assistant users browse, search, and control Spotify playback without leaving their home automation interface.

What language is ha-spotify-browser written in?

Mainly JavaScript. The stack also includes JavaScript, YAML, Home Assistant.

How hard is ha-spotify-browser to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ha-spotify-browser for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.