# philipstv
> Python CLI for controlling Philips Android-powered TVs

## 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

## When to Use
- 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

## When NOT to Use
- Your TV is not a Philips Android-powered TV
- Your TV is not connected to the local network
- 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

## Installation
- **pip**: `pip install 'philipstv[cli]'`

---
Source: https://littlescripts.sh/tools/philipstv