sonoscli

Sonos CLI

sonos를 사용하여 로컬 네트워크의 Sonos 스피커를 제어합니다.

빠른 시작

• sonos discover
• sonos status --name "부엌"
• sonos play|pause|stop --name "부엌"
• sonos volume set 15 --name "부엌"

일반 작업

• 그룹화: sonos group status|join|unjoin|party|solo
• 즐겨찾기: sonos favorites list|open
• 큐: sonos queue list|play|clear
• Spotify 검색 (SMAPI 통해): sonos smapi search --service "Spotify" --category tracks "검색어"

참고 사항

• SSDP가 실패하면 --ip <스피커-ip>를 지정하세요.
• Spotify Web API 검색은 선택 사항이며 SPOTIFY_CLIENT_ID/SECRET이 필요합니다.
• 오류가 발생하면 문제 해결 섹션을 확인하고 적절한 일치 항목이 있으면 조언을 제공하세요.

문제 해결

sonos discover - no route to host

• 오류 Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1) 발생 시
  • 0.0.0.0: 뒤의 포트 번호는 임시적이며 변경될 수 있고 넷마스크가 정확히 일치하지 않을 수도 있습니다.
  • sendto: no route to host는 일관되게 유지되어야 합니다.
• 사용자에게 direct(Docker 샌드박스 없음) 모드의 Mac OS에서 설정 -> 개인정보 보호 및 보안 -> 로컬 네트워크를 게이트웨이의 최상위 호스트 부모 프로세스에 대해 활성화해야 한다고 알립니다.
  • launchd를 통해 실행 중인 경우 node
  • 터미널에서 게이트웨이를 직접 실행하는 경우 Terminal
  • VS Code의 터미널을 통해 실행하는 경우 Visual Studio Code
• 대안으로 해당 샌드박스에 네트워크 접근이 허용된 sandbox(Docker 컨테이너)를 사용할 수 있습니다.

sonos discover - bind: operation not permitted

• 오류 Error: listen udp4 0.0.0.0:0: bind: operation not permitted 발생 시
• 사용자에게 Codex나 기타 네트워크 접근을 허용하지 않는 샌드박스를 통해 실행 중일 수 있다고 알립니다(샌드박스가 활성화된 Codex CLI 세션 내에서 sonos discover를 실행하고 승인 요청을 승인하지 않으면 재현 가능).