Philips Android TV component


Where to find best custom component to control Philips Android TV 55PUS7303 trough HASS?


That’s the one I used also. As for reverse engineering that sounds great but way over my head now.
As for Ipt2007, presently this seems to be the best option.


Hi @boloni

If I understand correct I must rename philips_2016_b1.xml to .py. And then put file to:


Is this correct?

Can you please post the configuration yaml for that component?


Example for configuration.yaml Philips Android TV component
How to receive user and password to your tv Philips Android TV component


it´s just like above said:

  - platform: philips_2016
    name: phTV
    host: 192.x.x.x
    username: yourusername
    password: yourpassword

as for the xml renaming and folder placing it is correct and also,
the name of the file you end up with has to match the platform name.
For the settings above the file must be renamed to


Where I can get username and password?


Post nr 1 in this thread.


The steps to access this API are:

  1. Get a pairing code from Philips ( )
  2. After this, you will receive an username and password
  3. Use this username and password to access the jointspace API ( using /6/ instead of /1/ and HTTPS instead of HTTP )

Yes I see that, but don’t understnd?

I go to link in 1. but only see code from


If anyone here is interested, I have created a custom light component for the Ambilights of Philips TV’s and opened a new topic for it, if you need any help with it, or have any suggestions for more features, I will be over there :slight_smile:


Has anyone already figured out how to use the “Wake on LAN” for post 2016 Philips Android TV’s?

I’m using the following configuration but it doesn’t work (yet):


  - platform: wake_on_lan
    mac_address: "aa:bb:cc:dd:ee:ff"

The WoWLAN function is switched on in my TV’s settings, can’t find a WoLAN setting


Thanks for the info.

I’m only interested in getting the Philips remote control app working for basic channel changing, volume, mouse and keyboard. With everything else I’m way out of my depth here. :blush:


OK Everyone after hours and hours and hours of learning,

I have successfully used this post to connect my Philips TV (Model: 43PUT6801/79 Man: June 2017) to my Home Assistant installation.



Source Select

Achieved Results
With this custom component I am able to connect the TV via a network connection, and am able to view what station it is on and what channel it is, I can also control the volume and power on/off on the TV as well as change the channel source to any other live TV station.

Some of the biggest challenges I faced when attempting this was, initially, that I had no knowledge of Python or Linux really for that matter.

My System
My current setup is a Raspberry Pi 3B running Hassio and Home assistant (HA) version 0.78 at the time of writing this.

Steps and Sources of Information:
I was interested in having my Philips TV communicate with Home Assistant.

This was a exciting feature as my current setup has xBox One, ps4, and kodi- libreelec media players sending what is playing to HA. The only device I had one way communication with was the Philips TV, as I was using an IR blaster to control this. Using a "Broadlink IR RM3 mini" and using this home assistant component. Using this I was able to control the TV as if I was using a remote control. However this was not telling my media player to current state of the TV which all other media devices were able to do. There had to be a solution.

See below for my Broadlink media player configuration.yaml before getting this custom component to work:


- platform: broadlink
  name: Philips IR Control
  mac: '78:0f:77:47:90:9e'
  ircodes_ini: 'broadlink_media_codes/philips.ini'

I tried the original joint space API with the Philips TV but my Tv was not supported as I purchased it 2017 and it is Android TV. Found this link in feature requests Philips Android TV component

Reading through this forum I noticed many people were having similar issues with various 2016+ Philips TVs.

The following steps provide this to work.

Gaining a username and password from the Philips 2016+ TV (Android)

  1. Read through the forums and found a Python script to retrieve username and password from the TV.

Script from Post number 2

This script was a little bit confusing for me at first, as it is called and the custom component Python script is called from post 2 Hope this clarifies the two different script names.

2 Different Scripts

The Pairing Script

The script by Suborb on github from post 1 gives the access to retrieve TV credentials from the Philips TV.

  1. Clone git the script to the Linux system ( see here for detailed info about git clone ).

git clone

  1. Change the directory to philips_android_tv

cd philips_android_tv

  1. Make sure the TV is on and is connected to a network

  2. Find the IP address of the TV using whatever method you need to e.g. router, Fing, etc

  3. Run the Python script
    python --host TVHOSTIP_ADDRESS_HERE pair


  1. Check the TV for the code that appears on the bottom right hand corner
    and use this code for the next step

  2. Go to a web browser and enter: http://YOURIPADDRESS:1926

  3. Enter the code as directed

You will be presented with a username and password similar to this:

Save these details for later.

The Custom Component Media Player Python Script

The script from martijnv worked best for my setup
the custom component media player and should be copied into the HA directory:

/config/custom_components/media_player .

Add Custom Media Player to Configuration.yaml

These details will be used in your configuration.yaml file when entering the media player information.

  1. Set up media player in configuration.yaml (Philips 2016+)

     - platform: philips_2016
       name: Philips TV
       host: 192.168.x.x
       username: user from pairing
       password: pass from pairing

Save your configuration.yaml and reboot the system.

  1. After system has rebooted check your states and locate the media player you just created

I reason for 2 of the same player is that I have a universal media player also that mimics the active mediaplayer in use see this link

Hope this helps.


I had this working on my Philips 55PUS6412, but after upgrading home assistant to version 0.80.0, I am getting some errors from the py script
“File “/config/custom_components/media_player/”, line 103, in volume_level
return self._volume / self._max_volume”
Anyone else having issues in the new HA version


I did some digging around, I really wanted to be able to launch apps.

Apparently someone figured it out after I failed (I even forgot that):
Here it is:


I may try to build a component incorporating everything found here.

Should have checked out this thread way earlier, this is a goldmine of great ways to control that philips tv


Just a quick overview of things I got working (using the scripts already shared here):

  • Play and Pause working (There is no PlayPause key (at least for me), so I had to check the actual state and set it to STATE_PLAYING or STATE_PAUSED)
  • Apps as sources instead of channels (since I don’t watch TV and have no sources except Google Play Movies trailers, I wanted to get that working)

Here is the updated

Be aware that channel switching is not supported anymore in favor of app switching.
I will add a config option later, so you can choose (or maybe enable both)


Constantly made improvements today for the app switching.

Now the current app is shown in the source select box :smiley:


i tried the new and getting errors in the log:
Unable to serialize to JSON: Object of type ‘dict_keys’ is not JSON serializable {‘id’: 2, ‘type’: ‘event’, ‘event’: {‘event_type’: ‘state_changed’, ‘data’: {‘entity_id’: ‘media_player.tvbeneden’, ‘old_state’: <state media_player.tvbeneden=playing; volume_level=0.26666666666666666, is_volume_muted=False, media_content_type=app, media_title=TV, app_name=TV, source_list=dict_keys([‘Help’, ‘Play Store’, ‘YouTube’, ‘Prime Video’, ‘Play Muziek’, ‘Play Games’, ‘Play Films’, ‘Netflix’, ‘Internet Browser’, ‘QuickSupport’, ‘TV-gids’, ‘Opnames’, ‘Bronnen’, ‘Media’, ‘Demomenu’, ‘Appgalerij’, ‘Topselectie’, ‘TV’, ‘Spotify’, ‘Tellybean’, ‘Notifications for Android TV’, ‘ARTE’, ‘Dailymotion’, ‘RTL XL’, ‘NPO’, ‘TV5Monde’, ‘Pathé Thuis’, ‘KIJK’, ‘FOX Sports NL’, ‘Megogo HD’, ‘Deezer’, ‘France24’, ‘Divan.TV’, ‘Social TV’, ‘GameTreeTV GOLD’, ‘Videoland’, ‘Filmbox Live’, ‘MovieMAX Online’, ‘Toon Goggles’, ‘Fishing TV’, ‘VLC’, ‘Instellingen’, ‘Zenders instellen’, ‘Zo kunt u…’, ‘Draadloos en netwerken’, ‘Apps beheren’, ‘Software bijwerken’]), friendly_name=TVbeneden, supported_features=23997 @ 2018-10-24T21:41:18.384159+02:00>, ‘new_state’: <state media_player.tvbeneden=paused; volume_level=0.2833333333333333, is_volume_muted=False, media_content_type=app, media_title=TV, app_name=TV, source_list=dict_keys([‘Help’, ‘Play Store’, ‘YouTube’, ‘Prime Video’, ‘Play Muziek’, ‘Play Games’, ‘Play Films’, ‘Netflix’, ‘Internet Browser’, ‘QuickSupport’, ‘TV-gids’, ‘Opnames’, ‘Bronnen’, ‘Media’, ‘Demomenu’, ‘Appgalerij’, ‘Topselectie’, ‘TV’, ‘Spotify’, ‘Tellybean’, ‘Notifications for Android TV’, ‘ARTE’, ‘Dailymotion’, ‘RTL XL’, ‘NPO’, ‘TV5Monde’, ‘Pathé Thuis’, ‘KIJK’, ‘FOX Sports NL’, ‘Megogo HD’, ‘Deezer’, ‘France24’, ‘Divan.TV’, ‘Social TV’, ‘GameTreeTV GOLD’, ‘Videoland’, ‘Filmbox Live’, ‘MovieMAX Online’, ‘Toon Goggles’, ‘Fishing TV’, ‘VLC’, ‘Instellingen’, ‘Zenders instellen’, ‘Zo kunt u…’, ‘Draadloos en netwerken’, ‘Apps beheren’, ‘Software bijwerken’]), …
21:43 components/websocket_api/ (ERROR)

Error executing query: Object of type ‘dict_keys’ is not JSON serializable


@Emilio_Emile Sorry, fixed that an hour ago with:

Please update the custom_component :wink:


Does turn on work for you without the wake-on lan feature?