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

# Welcome to clickwheel

> Sync your music library to a classic iPod from a modern Mac, with optional Claude/MCP control.

**clickwheel** keeps a classic **iPod** in sync with a modern Mac. Build
playlists from your local library and write them straight to the device, no
iTunes required. The same playlists push to **Plexamp** and **Apple Music**, and
your iPod listens scrobble to Last.fm.

<img src="https://mintcdn.com/clickwheel/lZoio4CBTXncgK_Z/images/ipod.jpg?fit=max&auto=format&n=lZoio4CBTXncgK_Z&q=85&s=7e2e50460a19e5b6997f2dc32d10ae54" alt="A classic iPod" width="2000" height="1046" data-path="images/ipod.jpg" />

## What it does

* **Manage your music**: index your library and [repair
  metadata](/guides/fix-metadata) in place. Album artist, year, cover art, and
  genres, without moving your files.
* **Build and move [playlists](/guides/playlists)**: curate named collections,
  then push and pull them between your [iPod](/guides/sync-to-ipod),
  [Plexamp](/guides/plex), and [Apple Music](/guides/apple-music).
* **[Scrobble](/guides/scrobbling)**: send your iPod listens to Last.fm.

## How to use it

* **As a [CLI](/reference/cli)**: scan your library, curate playlists with an
  interactive picker, and sync them to a device or service from your terminal.
* **As an [MCP server](/concepts/mcp-server)**: do all of it conversationally
  from Claude: *"build a 45-minute late-night mix and put it on my iPod,"*
  *"what's on my iPod?,"* *"push my road-trip playlist to Plexamp."*

## Who it's for

Anyone with a music library on a Mac and a classic iPod they still love. It's
single-tenant by design: your library and your iPod live on **your** machine,
and clickwheel works with them in place.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install, index your library, and load your iPod in a few commands.
  </Card>

  <Card title="MCP server" icon="robot" href="/concepts/mcp-server">
    Drive clickwheel from Claude, locally or from your phone.
  </Card>

  <Card title="CLI reference" icon="terminal" href="/reference/cli">
    Every command and flag (generated from the source).
  </Card>

  <Card title="Architecture" icon="sitemap" href="/concepts/architecture">
    How the pieces fit, and why it's Mac-as-source-of-truth.
  </Card>
</CardGroup>