# jishi/node-sonos-http-api

An HTTP API bridge for Sonos easing automation. Hostable on any node.js capable device, like a raspberry pi or similar.

Repository: https://github.com/jishi/node-sonos-http-api
Canonical: https://ross.abutalabs.com/products/node-sonos-http-api
Homepage: http://jishi.github.io/node-sonos-http-api/
Language: JavaScript
License: MIT
License Family: permissive
Topics: sonos, nodejs
Last push: 2025-03-22T11:45:06+00:00

## Health v2 (maintenance only)
Score: 28/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 12, release rhythm 8, longevity 100
- inputs: {"age_days": 4917, "days_push": 529, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1958, forks 475 (observed 2026-08-28T04:05:59.239800+00:00)

## What it is
A Node.js HTTP API bridge for controlling Sonos speakers, exposing simple REST-style endpoints for play, pause, volume, grouping, and presets. It can be hosted on any Node-capable device such as a Raspberry Pi to enable home automation integrations.

## Use cases
- control sonos speakers via http requests
- integrate sonos with home automation like home assistant
- pause all sonos zones at night with a webhook
- set volume on a sonos room from a script
- play a favorite playlist on sonos via curl
- run a sonos control api on a raspberry pi

## When to choose
- you want simple HTTP endpoints to automate Sonos playback
- you run a self-hosted automation hub like Home Assistant or Node-RED
- you need presets, sleep timers, and multi-room volume control from scripts

## When to avoid
- you need a guaranteed long-term API since Sonos may drop UPnP support
- you want a polished GUI for controlling Sonos
- you need cloud-based control such as IFTTT integration

## Facets
- artifact type: service
- maturity: maintenance
- function: http-server, api-framework, webhook
- domain: iot, self-hosted
- platform: self-hosted, iot
- tags: sonos, http-api, home-automation, upnp, music-control, automation, audio, nodejs, linux

## Member repositories
- jishi/node-sonos-http-api (main) score 28

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:59.239800+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:05:59.815959+00:00, confidence not recorded.
  - readme: https://github.com/jishi/node-sonos-http-api (fetched 2026-08-28T04:05:59.239800+00:00, sha 27337f97bb56)
  - homepage: http://jishi.github.io/node-sonos-http-api/ (fetched 2026-08-29T10:46:07.725363+00:00, sha c019ae35e9e5)
- Data as of 2026-08-30T08:39:29.467469+00:00.