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

# iPod

> clickwheel iPod commands and their options.

## `diff`

```bash theme={null}
clickwheel diff [OPTIONS] [PLAYLIST_NAME]
```

Preview changes before syncing to your iPod.

**Examples**

```bash theme={null}
# Preview changes for the 'ipod' playlist
clickwheel diff
```

<ParamField path="playlist_name" type="string" default="ipod">
  Playlist to diff against iPod
</ParamField>

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

## `eject`

```bash theme={null}
clickwheel eject [OPTIONS]
```

Safely disconnect the iPod.

**Examples**

```bash theme={null}
# Safely unmount before unplugging
clickwheel eject
```

## `ls`

```bash theme={null}
clickwheel ls [OPTIONS]
```

Show what's on your iPod.

**Examples**

```bash theme={null}
# Show what's on the iPod
clickwheel ls
```

## `select`

```bash theme={null}
clickwheel select [OPTIONS]
```

Pick artists and albums for your iPod.

**Examples**

```bash theme={null}
# Interactive picker; saved as the 'ipod' playlist
clickwheel select

# Build a named selection
clickwheel select --name "road-trip"
```

<ParamField path="--name, -n" type="string" default="ipod">
  Playlist name
</ParamField>

<ParamField path="--description, -d" type="string">
  Optional playlist description
</ParamField>

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

## `sync`

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

Send your playlist to the iPod.

**Examples**

```bash theme={null}
# Push the 'ipod' playlist to the device
clickwheel sync

# Show what would change without writing
clickwheel sync --dry-run

# Sync a specific playlist
clickwheel sync road-trip
```

<ParamField path="playlist_name" type="string" default="ipod">
  Playlist to sync
</ParamField>

<ParamField path="--dry-run" type="boolean">
  Show what would change without doing it
</ParamField>

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