Media Control

Experimental

Media endpoints are experimental and may change in future versions.

The media endpoints allow you to control system-wide media playback and retrieve information about what's currently playing.

Endpoints

Method	Endpoint	Description
`GET`	`/api/media/status`	Get current media playback info.
`POST`	`/api/media/control`	Control media playback.

Returns information about the currently playing media.

curl http://192.168.1.100:9990/api/media/status

Response

{
    "status": "active",
    "title": "Song Name",
    "artist": "Artist Name"
}

Field	Type	Description
`status`	string	Current status (see values below).
`title`	string	Current track title.
`artist`	string	Current artist name.

Value	Description
`active`	Media is playing or paused with metadata available.
`idle`	Session exists but no metadata.
`stopped`	No active media session.

Limitations

On Windows, the status returns "active" for both playing and paused states. Detecting exact play/pause state requires complex WinRT integration.

Send commands to control media playback.

curl -X POST http://192.168.1.100:9990/api/media/control \
  -H "Content-Type: application/json" \
  -d '{"action": "play"}'

{
    "action": "play"
}

{
    "status": "ok"
}

System-Wide Control

Media controls work with any application that responds to system media keys, including Spotify, Chrome, VLC, and more.