通过反向工程的 API(支持 MQTT!)控制 Philips TV(2015+)和 Ambilight(+ Hue)
Pylips is a Python tool to control Philips TVs (2015+) through their reverse-engineered API.
The current version of the API does not allow switching input sources anymore. For Android TVs with Google Assistant, Pylips can switch between any input sources that your TV has. For Android TVs without Google Assistant, see some options here.
Provided that you have python (version 3+) on your system, install all the dependencies first:
pip3 install -r requirements.txtYou may have to use pip and python instead of pip3 and python3 depending on how these tools are installed on your system.
To begin using Pylips you first need to add the ip adress of your TV to the [TV] section in the settings.ini file. If you want to use MQTT, you will also need to fill in the [MQTT] section and set the required flags in the [DEFAULT] section:
…Now turn your TV on and run Pylips without any arguments to complete setting it up (it will discover your TV's API version, port and protocol, and will also pair and save the credentials if required):
python3 pylips.py
Once it's done, you are ready to use Pylips!
Security note:
To pair with the Android TVs we need to create a HMAC signature using an 88-character (?) key. As far as I can tell the key is used for pairing only. With that in mind and to make this tool as user-friendly as possible, the key is hardcoded. I see no security issues with this but if you are extremely paranoid you can change it: look for a secret_key in the beginning of the code.
Custom config path:
You can load a custom config by specifying its absolute path with a --config parameter:
python pylips.py --config '/home/eslavnov/repos/Pylips/some_settings.ini'
You can take advantage of some of the built-in commands or send your own custom commands.
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command %command%Any passed arguments will override the settings in settings.ini without overwriting them. If you have already run the discovery for new users, you don't have to specify --host, --user and -pass parameters. Also skip the --user and --pass parameters if your TV does not have Android. Add --verbose False to any command if you don't want to see the feedback in your terminal (useful for command line sensors).
Available built-in commands:
TV status:
powerstate - Returns current power state of the TV ('On' or 'Off')
volume - Returns current volume and mute status
current_channel - Returns current channel (if in TV mode)
current_app - Returns current app (Android TVs only)
TV input (only for TVs with Google Assistant):
input_hdmi_1 - Switches TV's input to HDMI 1
input_hdmi_2 - Switches TV's input to HDMI 2
input_hdmi_3 - Switches TV's input to HDMI 3
input_hdmi_4 - Switches TV's input to HDMI 4
TV remote keys:
standby - Sends Standby key
mute - Sends Mute key
volume_up - Sends VolumeUp key
volume_down - Sends VolumeDown key
channel_up - Sends ChannelStepUp key
channel_down - Sends ChannelStepDown key
play - Sends Play key
pause - Sends Pause key
play_pause - Sends PlayPause key
stop - Sends Stop key
fast_forward - Sends FastForward key
rewind - Sends Rewind key
next - Sends Next key
previous - Sends Previous key
cursor_up - Sends CursorUp key
cursor_down - Sends CursorDown key
cursor_left - Sends CursorLeft key
cursor_right - Sends CursorRight key
confirm - Sends Confirm key
back - Sends Back key
home - Sends Home key
options - Sends Options key
info - Sends Info key
find - Sends Find key
adjust - Sends Adjust key
watch_tv - Sends WatchTV key
viewmode - Sends Viewmode key
teletext - Sends Teletext key
subtitle - Sends Subtitle key
record - Sends Record key
online - Sends Online key
source - Sends Source key
ambilight_onoff - Sends AmbilightOnOff key
red - Sends RedColour key
green - Sends GreenColour key
yellow - Sends YellowColour key
blue - Sends BlueColour key
dot - Sends Dot key
digit_0 - Sends Digit0 key
digit_1 - Sends Digit1 key
digit_2 - Sends Digit2 key
digit_3 - Sends Digit3 key
digit_4 - Sends Digit4 key
digit_5 - Sends Digit5 key
digit_6 - Sends Digit6 key
digit_7 - Sends Digit7 key
digit_8 - Sends Digit8 key
digit_9 - Sends Digit9 key
TV channels:
set_channel - Turns a specified channel on. Requires a valid --body argument, see the API reference to get it.
list_channels - Returns channel list
list_favorite - Returns favorite list
Ambilight:
ambilight_on - Turns ambilight on
ambilight_off - Turns ambilight off
ambihue_status - Returns the current status of 'Ambilight + Hue'
ambihue_on - Turns 'Ambilight + Hue' on
ambihue_off - Turns 'Ambilight + Hue' off
ambilight_color - Sets ambilight color (in HSB format). Requires a valid --body argument: {"hue": 360, "saturation": 100, "brightness": 255}
ambilight_brightness - Sets ambilight brightness. Requires a valid --body argument: {"value": 10}
ambilight_video_immersive - Sets Ambilight to 'Follow video' (Immersive)
ambilight_video_standard - Sets Ambilight to 'Follow video' (Standard)
ambilight_video_natural - Sets Ambilight to 'Follow video' (Natural)
ambilight_video_vivid - Sets Ambilight to 'Follow video' (Vivid)
ambilight_video_game - Sets Ambilight to 'Follow video' (Game)
ambilight_video_comfort - Sets Ambilight to 'Follow video' (Comfort)
ambilight_video_relax - Sets Ambilight to 'Follow video' (Relax)
ambilight_color_hot_lava - Sets Ambilight to 'Follow color' (Hot lava)
ambilight_color_warm_white - Sets Ambilight to 'Follow color' (Warm white)
ambilight_color_cool_white - Sets Ambilight to 'Follow color' (Cool white)
ambilight_color_fresh_nature - Sets Ambilight to 'Follow color' (Fresh nature)
ambilight_deep_water - Sets Ambilight to 'Follow color' (Deep water)
ambilight_audio_adapt_brightness - Sets Ambilight to 'Follow audio' (Energy Adaptive Brightness)
ambilight_audio_adapt_colors - Sets Ambilight to 'Follow audio' (Energy Adaptive Colors)
ambilight_audio_vu_meter - Sets Ambilight to 'Follow audio' (VU Meter)
ambilight_audio_spectrum - Sets Ambilight to 'Follow audio' (Spectrum Analyzer)
ambilight_audio_knight_rider_1 - Sets Ambilight to 'Follow audio' (Knight Rider Clockwise)
ambilight_audio_knight_rider_2 - Sets Ambilight to 'Follow audio' (Knight Rider Alternating)
ambilight_audio_flash - Sets Ambilight to 'Follow audio' (Random Pixel Flash)
ambilight_audio_strobo - Sets Ambilight to 'Follow audio' (Stroboscope)
ambilight_audio_party - Sets Ambilight to 'Follow audio' (Party)
ambilight_audio_random - Sets Ambilight to 'Follow audio' (Random Mode)
Other:
launch_app - Launches an app (Android TVs only). Requires a valid --body argument. See the API reference to get a list of installed apps, find your app in this list and use it as a --body argument.
power_on - Turns on the TV even if it's in a deep sleep mode. You might need to run allow_power_on first, although it was not needed for me.
allow_power_on - Allows to remotely power on the TV via chromecast requests.
google_assistant - Allows to pass requests to Google Assistant if your model supports it. Requires a --body argument containing a query with the command that you want to pass to Google Assistant. See example below.
Examples of using the built-in commands:
Send Stop key:
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command stopTurn Ambilight on:
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command ambilight_onLaunch YouTube:
…Launch Netflix:
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command launch_app --body '{"label":"Netflix","intent":{"component":{"packageName":"com.netflix.ninja","className":"com.netflix.ninja.MainActivity"},"action":"Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10000000 pkg=com.netflix.ninja cmp=com.netflix.ninja/.MainActivity }"},"order":0,"id":"com.netflix.ninja.MainActivity-com.netflix.ninja","type":"app"}'Launch Amazon Prime Video:
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command launch_app --body '{"id":"com.amazon.amazonvideo.livingroom","order":0,"intent":{"action":"Intent{act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10000000 pkg=com.amazon.amazonvideo.livingroom }","component":{"packageName":"com.amazon.amazonvideo.livingroom","className":"com.amazon.ignition.IgnitionActivity"}},"label":"Prime Video"}'Launch Kodi:
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command launch_app --body '{"id":"org.xbmc.kodi","order":0,"intent":{"action":"Intent{act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10000000 pkg=org.xbmc.kodi }","component":{"packageName":"org.xbmc.kodi","className":"org.xbmc.kodi.Splash"}},"label":"Kodi"}'Switch input to HDMI 1 using a built-in command (requires Google Assistant):
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command input_hdmi_1Switch input to any source (for example, SCART) using Google Assistant directly:
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command google_assistant --body '{"query":"SCART"}'Control connected lights in your house using Google Assistant:
python3 pylips.py --host %TV's_ip_address% --user %username% --pass %password% --command google_assistant --body '{"query":"Turn on lights"}'The tools exposes two general commands to talk to the TV's API: get (sends GET request and gets back some data like ambilight mode) and post (sends POST request that posts some data and changes something in the TV - like turning the ambilight off). You can also add custom commands to available_commands.json.
Read the API reference first to understand available endpoints and how to use them. There are some unexpected things like:
暂无开放 Issues,或尚未同步最近议题。