Marantz NR1609 HEOS CLI ProtocolSpecification Version 1.11 02072018 - Page 3

Overview

Page 3 highlights

1.7 1.8 1.9 1.10 1.11 1.373.100 Add Source id for each Music service and source Remove unused change events: source_data_changed, group_changed, player_mute_changed, group_mute_changed 1.397.190 Add support for Juke music service Add support for adding station to HEOS Favorites from browse menu Expand Thumbs Up/Down option to more music services [LS AVR only] Add new commands set_quickselect, play_quickselect, and get_quickselects. 1.406.140 Add support to Play Url 1.430.160 Add check_update command Add new response field 'serial' to get_players and get_player_info command responses Add new response fields 'available' and 'service_username' to get_music_sources and get_source_info command reponses Add QQMusic to the supported music service list 1.442.150 Add new field value (unknown) to network connection types Clarify on 'available' field in 'Get Music Sources' and 'Get Source Info' command response 09/21/2016 Prakash Mortha 04/12/2017 Prakash Mortha 05/23/2017 Prakash Mortha 11/20/2017 Prakash Mortha 02/15/2018 Prakash Mortha 1. Overview The Denon HEOS is a network connected, wireless, multi-room music system. The HEOS Command Line Interface (CLI) allows external control systems to manage, browse, play, and get status from the Denon HEOS products. The HEOS CLI is accessed through a telnet connection between the HEOS product and the control system. The control system sends commands and receives responses over the network connection. The CLI commands and responses are in human readable (ascii) format. The command is a text string and the responses are in JSON format. The commands and responses for browsing music servers and services use a RESTFUL like approach while other commands and responses are more static. 1.1 Supported music services Following table list out all supported online music services through HEOS. Please note, currently not all services are supported through CLI. Source ID (sid) Service Name Browse through CLI Search/New station through CLI 1 Pandora Yes Yes (Create New Station) 2 Rhapsody Yes Yes 3 TuneIn Yes Yes 4 Spotify No No 5 Deezer Yes Yes 6 Napster Yes Yes 7 iHeartRadio Yes Yes (Create New Station) 8 Sirius XM Yes No 9 Soundcloud Yes Yes 10 Tidal Yes Yes 11 Future service N/A N/A 12 Rdio Not supported in HEOS Not supported in HEOS 13 Amazon Music Yes No 14 Future service N/A N/A 15 Moodmix No No 16 Juke Yes Yes

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45

1.7
1.373.100
Add Source id for each Music service and source
Remove unused change events:
source_data_changed, group_changed, player_mute_changed, group_mute_changed
09/21/2016
Prakash
Mortha
1.8
1.397.190
Add support for Juke music service
Add support for adding station to HEOS Favorites from browse menu
Expand Thumbs Up/Down option to more music services
[LS AVR only] Add new commands set_quickselect, play_quickselect, and get_quickselects.
04/12/2017
Prakash
Mortha
1.9
1.406.140
Add support to Play Url
05/23/2017
Prakash
Mortha
1.10
1.430.160
Add check_update command
Add new response field 'serial' to get_players and get_player_info command responses
Add new response fields 'available' and 'service_username' to get_music_sources and
get_source_info command reponses
Add QQMusic to the supported music service list
11/20/2017
Prakash
Mortha
1.11
1.442.150
Add new field value (unknown) to network connection types
Clarify on 'available' field in 'Get Music Sources' and 'Get Source Info' command response
02/15/2018
Prakash
Mortha
1. Overview
The Denon HEOS is a network connected, wireless, multi-room music system. The HEOS Command Line Interface (CLI) allows external
control systems to manage, browse, play, and get status from the Denon HEOS products. The HEOS CLI is accessed through a telnet
connection between the HEOS product and the control system. The control system sends commands and receives responses over the
network connection. The CLI commands and responses are in human readable (ascii) format. The command is a text string and the
responses are in JSON format. The commands and responses for browsing music servers and services use a RESTFUL like approach while
other commands and responses are more static.
1.1 Supported music services
Following table list out all supported online music services through HEOS. Please note, currently not all services are supported through
CLI.
Source ID (sid)
Service Name
Browse through CLI
Search/New station through CLI
1
Pandora
Yes
Yes (Create New Station)
2
Rhapsody
Yes
Yes
3
TuneIn
Yes
Yes
4
Spotify
No
No
5
Deezer
Yes
Yes
6
Napster
Yes
Yes
7
iHeartRadio
Yes
Yes (Create New Station)
8
Sirius XM
Yes
No
9
Soundcloud
Yes
Yes
10
Tidal
Yes
Yes
11
Future service
N/A
N/A
12
Rdio
Not supported in HEOS
Not supported in HEOS
13
Amazon Music
Yes
No
14
Future service
N/A
N/A
15
Moodmix
No
No
16
Juke
Yes
Yes