📋

Sonoscli

Name: Sonoscli
Author: Peter Steinberger

명령줄에서 Sonos 스피커를 제어 — 기기 검색, 재생 관리, 볼륨 조절, 그룹 구성.

Peter Steinbergerv1.0.0

Productivity & TasksProductivityOpen SourceAutomationCLIDeveloper Tool

VM에 연결 중...

npx clawhub@latest install sonoscli

5현재 설치 수

1.3k누적 설치 수

v1.0.0버전

요구 사항

Spotify API Credentials(optional)

소스 보기(ClawHub)

스피커 검색 — SSDP를 통해 로컬 네트워크의 모든 Sonos 기기를 자동으로 찾습니다.
재생 제어 — 이름으로 임의의 스피커를 재생, 일시 중지 또는 정지합니다.
볼륨 관리 — 개별 스피커에 정확한 볼륨 레벨을 설정합니다.
그룹 제어 — 간단한 명령으로 스피커를 참여, 탈퇴, 파티 모드 또는 솔로로 설정합니다.
즐겨찾기 및 대기열 — Sonos 즐겨찾기를 탐색하고 재생하며 재생 대기열을 관리합니다.
Spotify 검색 — SMAPI를 통해 Spotify 트랙을 검색합니다（선택적 Spotify 자격 증명 필요）.

작동 원리

Step 1

CLI 설치

sonos 바이너리는 Go를 통해 설치되며 로컬 네트워크를 통해 Sonos 스피커와 직접 통신합니다.

Step 2

기기 검색

sonos discover를 실행하여 SSDP 멀티캐스트를 사용해 모든 스피커를 찾습니다. SSDP가 실패하면 --ip로 스피커 IP를 직접 지정합니다.

Step 3

명령 실행

--name을 사용하여 이름으로 스피커를 대상으로 지정하고 재생, 볼륨 또는 그룹 명령을 실행합니다.

Step 4

선택적 Spotify 통합

SMAPI 프로토콜을 통해 Spotify 검색을 활성화하려면 SPOTIFY_CLIENT_ID 및 SPOTIFY_CLIENT_SECRET 환경 변수를 제공합니다.

주요 기능

클라우드 종속성 없음

로컬 네트워크를 통해 Sonos 스피커와 직접 통신; 기본 사용에 Sonos 계정이 필요하지 않습니다.

이름으로 스피커 지정

--name "방 이름"을 사용하여 Sonos 방 레이블로 임의의 스피커를 대상으로 지정합니다.

그룹 관리

완전한 그룹 수명 주기: 상태 확인, 참여, 탈퇴, 파티 모드, 솔로.

대기열 제어

재생 대기열을 나열, 재생 및 지웁니다.

즐겨찾기 재생

CLI에서 Sonos 즐겨찾기를 나열하고 엽니다.

Spotify SMAPI 검색

터미널을 떠나지 않고 Spotify 콘텐츠를 검색합니다（선택적 자격 증명 필요）.

요구 사항

Sonos 스피커

CLI를 실행하는 컴퓨터와 동일한 로컬 네트워크에 있는 하나 이상의 Sonos 기기.

Go 툴체인

go install을 통해 sonos 바이너리를 설치하는 데 필요합니다.

네트워크 액세스

SSDP 멀티캐스트에 도달할 수 있어야 합니다; 그렇지 않으면 --ip <speaker-ip>를 대체로 사용합니다.

Spotify 자격 증명 (선택 사항)

Spotify SMAPI 검색에만 SPOTIFY_CLIENT_ID 및 SPOTIFY_CLIENT_SECRET이 필요합니다.

활용 사례

홈 자동화 스크립트

셸 스크립트나 cron 작업의 일부로 음악 재생 트리거, 볼륨 조정 또는 스피커 음소거.

AI 어시스턴트 통합

Clawdbot이 자연어 명령으로 Sonos 스피커를 제어할 수 있게 합니다.

아침/저녁 루틴

설정된 시간에 스피커 그룹화 및 볼륨 레벨을 자동화합니다.

개발 환경

집중 작업 중에 터미널을 떠나지 않고 스피커를 빠르게 음소거하거나 제어합니다.

설치 방법

Run in your terminal

npx clawhub@latest install sonoscli

Click the Install button at the top of this page for one-click setup

VM에 연결 중...

npx clawhub@latest install sonoscli

5현재 설치 수

1.3k누적 설치 수

v1.0.0버전

요구 사항

Spotify API Credentials(optional)

소스 보기(ClawHub)

자주 묻는 질문

리뷰

0개 리뷰

리뷰를 작성하려면 로그인

아직 리뷰가 없습니다. 첫 번째로 경험을 공유해 보세요!