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

# Build and edit playlists

> Curate named playlists for the iPod (and Plex/Apple Music).

Playlists are named, saved collections stored in clickwheel's catalog. They show
up under Music → Playlists on the iPod once synced.

## Create and edit

```bash theme={null}
clickwheel playlist                      # list saved playlists
clickwheel edit                          # open the interactive editor
clickwheel edit --add "Nirvana"          # add an artist (scriptable)
clickwheel edit --remove "Beastie Boys"  # remove an artist
clickwheel delete <name>                 # delete a playlist
```

You can edit by **artist** or by **individual song**. The interactive editor
offers "Add songs" / "Remove songs" (search, then check the tracks you want).
The same is scriptable with a track's full library path:

```bash theme={null}
clickwheel edit "road trip" --add-track "~/Music/Nirvana/Nevermind/In Bloom.m4a"
```

## Put a playlist on the iPod

```bash theme={null}
clickwheel sync   # syncs your selected playlist to the device
```

See [Sync to iPod](/guides/sync-to-ipod) for the full flow.

## Playlists vs. loading the device

Two different things, easy to mix up:

* **Just adding music**: you want tracks browsable by artist and album on the
  iPod. No named playlist needed, see [Sync to iPod](/guides/sync-to-ipod).
* **A playlist**: a named collection that shows up under Music → Playlists on
  the device.

These playlists can also go to [Plex/Plexamp](/guides/plex) and
[Apple Music](/guides/apple-music).