philipstv

Python CLI for controlling Philips Android-powered TVs

Media linuxmacoswindows Python MIT

Description

philipstv is a Python package providing a CLI and library for interacting with Philips Android-powered TVs. It lets you control power, volume, channels, Ambilight settings, and launch apps from the terminal. The tool communicates with the TV over the local network using the Philips JointSpace API. Requires initial pairing with the TV before use.

Install

pippip install 'philipstv[cli]'

AI Summary

CLI and Python library for controlling Philips Android TVs over the local network.

Capabilities

+ Pair with a Philips Android TV on the local network
+ Turn TV power on and off
+ Get and set volume level
+ List and switch TV channels
+ Emulate remote control key presses
+ Control Ambilight power state and color
+ List and launch installed applications

Use When

→ You want to control a Philips Android TV from the terminal
→ You are building smart home automation scripts involving a Philips TV
→ You want quick control without reaching for the physical remote

Avoid When

x Your TV is not a Philips Android-powered TV
x Your TV is not connected to the local network
x You need a graphical remote control interface

Usage Patterns

Pair with a TV

philipstv pair 192.168.1.100

Initiates pairing with the TV at the given IP address

Turn on the TV

philipstv power set on

Sets the TV power state to on

Set volume

philipstv volume set 15

Sets the TV volume to 15

Launch an app

philipstv launch Netflix

Launches the Netflix app on the TV

List installed apps

philipstv app list

Lists all installed applications on the TV

Control Ambilight

philipstv ambilight set on

Turns on the Ambilight feature

View AGENTS.md for philipstv