====== Eunhasu CMD URL ======

This feature is supported from Eunhasu V0.6.5.

===== CMD URL =====

CMD URL (App control URL) lets you start, stop, and restart apps on your Eunhasu device and check their status by entering a URL in your browser's address bar. You can control an app with a single URL without navigating through the Web GUI menus.

Use it from a web browser on a PC or smart device connected to the same network as the Eunhasu device. In the instructions below, replace <IP> with the IP address of your device (e.g. 192.168.0.38).

===== App list and status =====

Enter the address below in your browser's address bar to see the list of controllable apps, the current status of each app, and the URLs to use.

<code>http://<IP>/cmd/</code>

{{ :ko:cmd_01_list.jpg |}}

  * **app**: The name of the app to control.
  * **status**: The current status of the app. 'active' means running, and 'inactive' means stopped.
  * **start / stop / restart**: The URLs used for each action.

===== CMD URL usage =====

Enter the URL in the format below, adding Start, Stop, or Restart after the app name.

<code>http://<IP>/cmd/<app name><action></code>

^ Action ^ Example URL (Roon Ready) ^ Result ^
| Start | ''%%http://<IP>/cmd/roonreadyStart%%'' | Starts the app. |
| Stop | ''%%http://<IP>/cmd/roonreadyStop%%'' | Stops the app. |
| Restart | ''%%http://<IP>/cmd/roonreadyRestart%%'' | Stops the app and starts it again. |

After you enter a URL, the result is shown in a single line. 'OK' means the command was processed successfully, and the status after the action is shown after the arrow (->).

<code>OK    roonready  start  ->  active</code>

<note tip>Enter the URL exactly as shown on the list screen, including upper and lower case.</note>

==== Start ====

Add Start after the app name. If the result shows 'active', the app has started.

{{ :ko:cmd_02_start.jpg |}}

Refresh the Eunhasu home screen, and the app is shown as 'Active'.

{{ :ko:cmd_03_start_ui.jpg |}}

==== Stop ====

Add Stop after the app name. If the result shows 'inactive', the app has stopped.

{{ :ko:cmd_04_stop.jpg |}}

Refresh the Eunhasu home screen, and the 'Active' label disappears and the app name (Roon Ready) is shown.

{{ :ko:cmd_05_stop_ui.jpg |}}

==== Restart ====

Add Restart after the app name. The app stops and starts again, and the result shows 'active'. Use this when an app is not working properly.

{{ :ko:cmd_06_restart.jpg |}}

{{ :ko:cmd_07_restart_ui.jpg |}}

===== Supported apps =====

The apps you can control with CMD URL are listed below. Each app's URL is ''%%http://<IP>/cmd/%%'' followed by the app name and the action (e.g. mpdStart, mpdStop, mpdRestart).

^ App name (app) ^ Description ^
| roonready | [[:en:roon#roon_ready|Roon Ready]] |
| roonserver | [[:en:roon#roon_server|Roon Server]] |
| mpd | [[:en:mpd|MPD (Music Player Daemon)]] |
| qobuz | Qobuz Connect |
| hqplayer | HQPlayer Embedded |
| hqplayernaa | [[:en:hqplayer_naa|HQPlayer NAA]] |
| lms | LMS (Lyrion Music Server) |
| squeezelite | [[:en:squeezelite|Squeezelite]] |
| shairport | [[:en:shairport|Shairport]] (AirPlay receiver) |
| librespot | [[:en:librespot|LibreSpot]] (Spotify Connect) |
| minimserver | [[:en:minimserver|MinimServer]] |
| bubbleserver | BubbleUPnP Server |
| diretta | Diretta |
| audirvana | Audirvana |