TuneBlade Simple Remote API
Simple Remote API can be used to control TuneBlade to connect/disconnect and change volume of AirPlay receivers. For all other controls refer to the older API pdf hosted on http://www.tuneblade.com/developer/.
Finding the IP and port of TuneBlade remote on the network:
- Auto-Discovery/Zeroconf: TuneBlade remote API is discoverable using Zeroconf protocol with the following details: Reg Type: “_http._tcp” , Name: <MachineName>@TuneBlade . Apple Bonjour's service on Windows and Mac, and Avahi on Linux are commonly used for auto-discovery.
- Manual: The IP address of the machine on which TuneBlade is running can be found via ipconfig or any other method. (When controlling TuneBlade on the same machine, “localhost” instead of IP address can be used.) The port number can be set manually in TuneBlade Setting --> Remote Control Section.
Get list of all AirPlay receivers including connection and volume status.
Format: http://<IP Address:Port Number>/v2
Example: http://192.168.129.161:54412/v2
Example of Response Body:
MASTER 0 10 Master 59118 0 0 Apple TV Manual C869CD7186DB 0 40 Apple TV 6BDF379163D2 0 64 TuneAero2
The first row is for “Master” control status. This row will only be present if the “Master” control is enabled in TuneBlade settings.
Each row corresponds to an AirPlay receiver. The first word is the ID of the device. (This ID will be used to control devices individually.) The second is the status (0 = Disconnected, 100 = Connected) . The third is the volume level (0-100). The remainder is the friendly name of the AirPlay device.
Get connection and volume status of a particular AirPlay receiver.
Format: http://<IP Address:Port Number>/v2/<ID>
Example: http://192.168.129.161:54412/v2/6BDF379163D2/
Example of Response Body:
0 65
The first number is connection status ( 0 = Disconnected, 100 = Connected), second is the volume(0-100).
Connect/Disconnect to a particular AirPlay receiver.
Format: http://<IP Address:Port Number>/v2/<ID>/Status/<Connect/Disconnect>
Example: http://192.168.129.161:54412/v2/6BDF379163D2/Status/Connect
Change volume of a particular AirPlay receiver
Format: http://<IP Address:Port Number>/v2/<ID>/Volume/Volume Level 0-100
Example: http://192.168.129.161:54412/v2/6BDF379163D2/Volume/20
To control master volume and connection status, replace the ID with “master” in the above URLs. This is available only if Master control is enabled in TuneBlade settings.
Please feel free to contact us at support@tuneblade.com or visit the discussion forum.