SOtM docs

Eunhasu CMD URL

Eunhasu V0.6.5부터 지원되는 기능입니다.

CMD URL

CMD URL(App control URL)은 브라우저 주소창에 URL을 입력해 Eunhasu 기기의 앱을 시작, 중지, 재시작하고 상태를 확인하는 기능입니다. Web GUI에서 메뉴를 찾아 들어가지 않아도 URL 하나로 앱을 제어할 수 있습니다.

Eunhasu 기기와 같은 네트워크에 연결된 PC나 스마트 기기의 웹 브라우저에서 사용합니다. 아래 설명의 <IP>는 사용하는 기기의 IP 주소로 바꿔 입력합니다(예: 192.168.0.38).

앱 목록과 상태 확인

브라우저 주소창에 아래 주소를 입력하면 제어할 수 있는 앱 목록과 각 앱의 현재 상태, 사용할 URL이 표시됩니다.

http://<IP>/cmd/

  • app: 제어할 앱의 이름입니다.
  • status: 앱의 현재 상태입니다. 'active'는 실행 중, 'inactive'는 중지된 상태입니다.
  • start / stop / restart: 각 동작에 사용하는 URL입니다.

CMD URL 사용 방법

URL은 아래 형식으로 입력합니다. 앱 이름 뒤에 Start, Stop, Restart 중 하나를 붙입니다.

http://<IP>/cmd/<앱 이름><동작>
동작 URL 예시 (Roon Ready) 결과
시작 http://<IP>/cmd/roonreadyStart 앱을 실행합니다.
중지 http://<IP>/cmd/roonreadyStop 앱을 중지합니다.
재시작 http://<IP>/cmd/roonreadyRestart 앱을 중지한 후 다시 실행합니다.

URL을 입력하면 결과가 한 줄로 표시됩니다. 'OK'는 명령이 정상적으로 처리되었다는 뜻이고, 화살표(→) 뒤에 실행 후의 상태가 표시됩니다.

OK    roonready  start  ->  active
URL은 목록 화면에 표시된 그대로(대소문자 포함) 입력합니다.

시작하기 (Start)

앱 이름 뒤에 Start를 붙여 입력합니다. 결과에 'active'가 표시되면 앱이 실행된 것입니다.

Eunhasu 홈 화면을 새로고침하면 해당 앱이 'Active'로 표시됩니다.

중지하기 (Stop)

앱 이름 뒤에 Stop을 붙여 입력합니다. 결과에 'inactive'가 표시되면 앱이 중지된 것입니다.

Eunhasu 홈 화면을 새로고침하면 'Active' 표시가 사라지고 앱 이름(Roon Ready)이 표시됩니다.

재시작하기 (Restart)

앱 이름 뒤에 Restart를 붙여 입력합니다. 앱이 중지된 후 다시 실행되며, 결과에 'active'가 표시됩니다. 앱이 정상적으로 동작하지 않을 때 사용합니다.

지원 앱 목록

CMD URL로 제어할 수 있는 앱은 아래와 같습니다. 각 앱의 URL은 http://<IP>/cmd/ 뒤에 앱 이름과 동작을 붙인 형식입니다(예: mpdStart, mpdStop, mpdRestart).

앱 이름 (app) 설명
roonready Roon Ready
roonserver Roon Server
mpd MPD (Music Player Daemon)
qobuz Qobuz Connect
hqplayer HQPlayer Embedded
hqplayernaa HQPlayer NAA
lms LMS (Lyrion Music Server)
squeezelite Squeezelite
shairport Shairport (AirPlay 수신)
librespot LibreSpot (Spotify Connect)
minimserver MinimServer
bubbleserver BubbleUPnP Server
diretta Diretta
audirvana Audirvana