Plex Ctl

# plexctl — Plex Media Server Control

> Standalone CLI for controlling Plex Media Server and clients via the Plex API

## When to Use

**Trigger phrases:**
- "play [title] on Plex"
- "search Plex for [query]"
- "what's playing on Plex"
- "pause/resume Plex"
- "show me what's on deck"
- "what's new on Plex"
- "list Plex clients"
- "tell me about [movie/show]"

**Use this skill when:**
- User wants to play specific content on Plex
- User wants to search their Plex library
- User wants to control playback (pause, resume, stop, next, prev)
- User wants to see what's currently playing
- User wants to browse recently added content
- User wants to see continue watching (on-deck)
- User wants detailed info about a title

**Don't use this skill when:**
- User wants Apple TV-specific navigation (use ClawTV instead)
- User wants vision-based automation (use ClawTV instead)
- User wants to manage Plex server settings (use Plex web UI)

## Commands

### Setup
```bash
plexctl setup
```
Interactive first-time setup:
- Plex server URL (e.g., http://192.168.86.86:32400)
- Plex token
- Default client selection

### Playback
```bash
# Play a movie (fuzzy search)
plexctl play "Fight Club"
plexctl play "inception"

# Play specific TV episode
plexctl play "The Office" -s 3 -e 10
plexctl play "Westworld" --season 2 --episode 6

# Play on specific client (overrides default)
plexctl play "Matrix" -c "Living Room TV"
```

### Playback Control
```bash
plexctl pause              # Pause current playback
plexctl resume             # Resume playback
plexctl stop               # Stop playback
plexctl next               # Skip to next track/episode
plexctl prev               # Go to previous track/episode
```

### Search & Discovery
```bash
# Search across all libraries
plexctl search "matrix"
plexctl search "breaking bad"

# Recently added content
plexctl recent             # Last 10 items
plexctl recent -n 20       # Last 20 items

# Continue watching (on-deck)
plexctl on-deck

# What's current...

# plexctl

> Standalone CLI for controlling Plex Media Server and clients via the Plex API

Fast, simple Plex control from the command line. No Apple TV, no vision, no automation — just direct Plex API calls.

## What It Does

- **Play content** — Movies, TV shows, music with fuzzy search
- **Control playback** — Pause, resume, stop, next, previous
- **Search library** — Find content across all your Plex libraries
- **Browse content** — Recently added, on-deck (continue watching)
- **Get info** — Detailed metadata about any title
- **Multi-client** — Control any Plex client on your network

## Quick Start

### 1. Install
```bash
pip install plexapi
```

### 2. Setup
```bash
chmod +x plexctl.py
./plexctl.py setup
```

You'll need:
- Plex server URL (e.g., `http://192.168.86.86:32400`)
- Plex token (see [Getting Your Plex Token](#getting-your-plex-token))
- Default client (auto-discovered during setup)

### 3. Use
```bash
./plexctl.py play "Fight Club"
./plexctl.py search "matrix"
./plexctl.py now-playing
./plexctl.py pause
```

## All Commands

### Playback
```bash
# Play a movie
plexctl play "Inception"
plexctl play "fight club"

# Play TV show episode
plexctl play "The Office" -s 3 -e 10
plexctl play "Breaking Bad" --season 5 --episode 14

# Play on specific client
plexctl play "Matrix" -c "Bedroom TV"
```

### Playback Control
```bash
plexctl pause              # Pause current playback
plexctl resume             # Resume playback
plexctl stop               # Stop playback
plexctl next               # Next track/episode
plexctl prev               # Previous track/episode
```

### Search & Discovery
```bash
# Search library
plexctl search "christopher nolan"
plexctl search "breaking"

# Recently added
plexctl recent             # Last 10 items
plexctl recent -n 20       # Last 20 items

# Continue watching
plexctl on-deck

# What's playing
plexctl now-playing

# Get detailed info
plexctl info "Inception"
```

### Library
```bash
plexctl libraries          # List all...