> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickwheel.fm/llms.txt
> Use this file to discover all available pages before exploring further.

# Plex

> clickwheel Plex commands and their options.

## `doctor`

```bash theme={null}
clickwheel plex doctor [OPTIONS]
```

Probe your Plex config end-to-end. Reports each stage (config,
plexapi install, server connect, music section lookup, sample-track
resolution) so failures point at exactly what's broken.

**Examples**

```bash theme={null}
# Diagnose the Plex connection (five stages)
clickwheel plex doctor
```

## `list`

```bash theme={null}
clickwheel plex list [OPTIONS]
```

List every audio playlist on your Plex server, with kind and size.

**Examples**

```bash theme={null}
# List Plex audio playlists
clickwheel plex list
```

## `pull`

```bash theme={null}
clickwheel plex pull [OPTIONS] NAME
```

Pull a playlist from Plex back into clickwheel's local store.

For recovering hand-curated playlists after a clean install (Plex keeps
them server-side; clickwheel's catalog didn't). Tracks are matched against
your library; unmatched ones are reported so you can chase them.

**Examples**

```bash theme={null}
# Import a Plex playlist into clickwheel
clickwheel plex pull road-trip
```

<ParamField path="name" type="string" required>
  Plex playlist to pull into clickwheel.
</ParamField>

<ParamField path="--include-smart" type="boolean">
  Allow pulling a smart playlist (freezes a snapshot).
</ParamField>

<ParamField path="--overwrite" type="boolean">
  Replace an existing clickwheel playlist with the same name.
</ParamField>

## `sync-plex`

```bash theme={null}
clickwheel sync-plex [OPTIONS] [PLAYLIST_NAME]
```

Push playlist(s) to your Plex music library.

**Examples**

```bash theme={null}
# Push one playlist to Plex
clickwheel sync-plex road-trip

# Push every clickwheel playlist
clickwheel sync-plex --all
```

<ParamField path="playlist_name" type="string">
  Playlist to push to Plex. Omit with --all to push every playlist.
</ParamField>

<ParamField path="--all" type="boolean">
  Push every clickwheel playlist to Plex.
</ParamField>

<ParamField path="--no-scan" type="boolean">
  Skip automatic library scan.
</ParamField>