homebridge-musiccast-tv

Features

This plugin publishes MusicCast devices as HomeKit compatible TVs. It supports any number of inputs and volume control via the Apple TV Remote widget in the iOS Control Center. You can enable an additional fan service for volume control by adding volumeFan = 1 and volumeName to your config.json.

Configuration

    "accessories": [{
        "accessory": "MusicCastTV",
        "name": "Living Room Radio",
        "ip": "192.168.178.2",
        "inputs": {
            "airplay": "AirPlay", 
            "am": "AM", 
            "fm": "FM", 
            "line_cd": "CD", 
            "hdmi1": "DVD Player", 
            "server": "Homeserver", 
            "net_radio": "Online radio"
            }
    }]

Installation

Install Homebridge

sudo npm install -g homebridge
sudo npm install -g homebridge-musiccast-tv

Configure Homebridge

You can get information about your MusicCast device by visiting "http://\<ip>/YamahaExtendedControl/v1/system/getFeatures".

config arguments:

name	example	description	required
accessory	MusicCastTV	this value is used to identify this plugin	yes
name	"TV stereo"	the name of your device	yes
ip	192.168.178.29	ip address for your MusicCast device	yes
zone	"zone2"	MusicCast zone from getFeatures.json, default: "main"	no
inputs	{"fm": "radio", "line_cd": "CD", "airplay": "AirPlay"}	one key:value pair for each input you want to use. You can hide inputs by removing the checkbox in your HomeKit app or by removing it here.	yes
model	"Yamaha R-N602"	device model shown in homebridge	no
serialNo	"123-456-789"	serial number shown in homebridge	no
volumeFan	1	show additional fan service for volume control	no
volumeName	"TV speaker"	the name of the additional fan service	no
buttonNumber	11	show additional switch for setting the radio to favourite station no ...	no
buttonName	"radio station 11"	the name of the additional switch	no
buttonBand	"fm"	the tuner band for the additional switch	no
powerOnInput	"line_cd"	input automatically switched to at powerOn	no
powerOnVolume	60	Volume your device is set to at powerOn	no
updateInterval	1000	time between updates im ms	no
volume	100	initial Volume; automatically detected	no
maxVol	161	maxVol from getFeatures.json; automatically detected	no

Currently supported inputs:

Input Name	Implemented
phono	yes
line_cd	yes
line1	yes
line2	yes
line3	yes
usb	yes
usb_dac	yes
airplay	yes
bluetooth	yes
net_radio	yes
server	yes
optical	yes
optical1	yes
optical2	yes
coaxial	yes
coaxial1	yes
coaxial2	yes
hdmi	yes
hdmi[1-8]	yes
aux	yes
aux1	yes
aux2	yes
v_aux	yes
av[1-7]	yes
cd	yes
tv	yes
analog	yes
multi_ch	yes
audio	yes
audio[1-4]	yes
audio_cd	yes
digital	yes
digital1	yes
digital2	yes
bd_dvd	yes
mc_link	yes
main_sync	no
tuner types:
fm	yes
am	yes
dab	yes
streaming services:
spotify	yes
amazon_music	yes
deezer	yes
napster	yes
qobuz	yes
juke	yes
tidal	yes
pandora	yes
siriusxm	yes
radiko	yes
alexa	yes

If your MusicCast device supports additional inputs, please file an issue.

hdmi[1-8] summarizes hdmi1, hdmi2, ..., hdmi8

Debugging

check you are using the right ip-adress
check your log file for error messages
run in debug mode using "homebridge -D" and file an issue

Common issues

Input appears as additional tile

remove and repair Homebridge
restart Homebridge

Issues with more than one TV per bridge

If you have more than one TV per Homebridge instance you might experience some of the following issues:

only one TV appears in the TV widget
one or multiple TVs have problems syncing to Homebridge
one or more TVs are flashing in the Home app

To fix these Issues make sure there is just one TV per Homebridge instance. You can run multiple Homebridge instances per device.

TODO

[x] add fan service for volume control
[ ] fix symbol
[ ] create plattform accesory

aangert / homebridge-musiccast-tv

readme