phil
ad963000f6
Change installation instructions from libcec-rpi to cec-utils which is the correct package name for Raspberry Pi OS (Raspbian). Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
72 lines
2.1 KiB
Markdown
72 lines
2.1 KiB
Markdown
# CEC Control for Raspberry Pi 4
|
|
|
|
Control HDMI-connected devices (TVs, receivers, etc.) from your Raspberry Pi 4 using CEC (Consumer Electronics Control).
|
|
|
|
## Installation
|
|
|
|
1. Install the required CEC utilities:
|
|
```bash
|
|
sudo apt-get update
|
|
sudo apt-get install cec-utils
|
|
```
|
|
|
|
2. Make the script executable (already done):
|
|
```bash
|
|
chmod +x cec-control.sh
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
./cec-control.sh <command> [options]
|
|
```
|
|
|
|
## Available Commands
|
|
|
|
| Command | Description | Example |
|
|
|---------|-------------|---------|
|
|
| `tv-on` | Turn on the TV | `./cec-control.sh tv-on` |
|
|
| `tv-off` | Turn off the TV | `./cec-control.sh tv-off` |
|
|
| `standby` | Put TV in standby | `./cec-control.sh standby` |
|
|
| `wake` | Wake TV from standby | `./cec-control.sh wake` |
|
|
| `vol-up` | Increase volume | `./cec-control.sh vol-up` |
|
|
| `vol-down` | Decrease volume | `./cec-control.sh vol-down` |
|
|
| `mute` | Mute audio | `./cec-control.sh mute` |
|
|
| `input <port>` | Switch HDMI input (0-15) | `./cec-control.sh input 1` |
|
|
| `source <device>` | Switch source device (0-15) | `./cec-control.sh source 2` |
|
|
| `scan` | Scan for CEC devices | `./cec-control.sh scan` |
|
|
| `status` | Show CEC adapter status | `./cec-control.sh status` |
|
|
| `info` | Show TV information | `./cec-control.sh info` |
|
|
| `raw <command>` | Send raw CEC command | `./cec-control.sh raw 4f:82:10:00` |
|
|
| `help` | Show help message | `./cec-control.sh help` |
|
|
|
|
## Quick Start
|
|
|
|
1. Connect your Raspberry Pi to your TV via HDMI
|
|
2. Enable CEC on your TV (usually in settings)
|
|
3. Test the connection:
|
|
```bash
|
|
./cec-control.sh scan
|
|
```
|
|
4. Turn on your TV:
|
|
```bash
|
|
./cec-control.sh tv-on
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
- **CEC not working**: Make sure CEC is enabled in your TV settings
|
|
- **Permission denied**: Run with `sudo` if needed
|
|
- **Device not found**: Check HDMI connection and try rescanning with `scan` command
|
|
|
|
## Advanced Usage
|
|
|
|
You can integrate this script into your own automation:
|
|
```bash
|
|
# Turn on TV and switch to input 1
|
|
./cec-control.sh tv-on && sleep 2 && ./cec-control.sh input 1
|
|
|
|
# Use in cron jobs or other scripts
|
|
@reboot /path/to/cec-control.sh tv-on
|
|
```
|