# clickwheel

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

## Docs

- [Changelog](https://docs.clickwheel.fm/changelog.md): Release history.
- [Architecture](https://docs.clickwheel.fm/concepts/architecture.md): How clickwheel's pieces fit together.
- [Design principles](https://docs.clickwheel.fm/concepts/design.md): The deliberate constraints behind clickwheel.
- [MCP server](https://docs.clickwheel.fm/concepts/mcp-server.md): Drive clickwheel from Claude and other MCP clients.
- [Apple Music](https://docs.clickwheel.fm/guides/apple-music.md): Sync clickwheel playlists to Apple Music and import them back.
- [Repair metadata](https://docs.clickwheel.fm/guides/fix-metadata.md): Fix album artists, fetch art, year, and genres — in place.
- [Build and edit playlists](https://docs.clickwheel.fm/guides/playlists.md): Curate named playlists for the iPod (and Plex/Apple Music).
- [Plex / Plexamp](https://docs.clickwheel.fm/guides/plex.md): Push clickwheel playlists to Plex, and recover them back.
- [Remote / mobile access](https://docs.clickwheel.fm/guides/remote-mcp.md): Use clickwheel from the Claude apps, including your phone.
- [Scrobble to Last.fm](https://docs.clickwheel.fm/guides/scrobbling.md): Submit your iPod listens to Last.fm.
- [Sync music to your iPod](https://docs.clickwheel.fm/guides/sync-to-ipod.md): Load and update a classic iPod from your library.
- [clickwheel](https://docs.clickwheel.fm/introduction.md): Sync your music library to a classic iPod from a modern Mac — with optional Claude/MCP control.
- [Quickstart](https://docs.clickwheel.fm/quickstart.md): Install clickwheel, index your library, and load your iPod.
- [CLI reference](https://docs.clickwheel.fm/reference/cli.md): Every clickwheel command and option.
- [Configuration](https://docs.clickwheel.fm/reference/configuration.md): clickwheel's config file and environment variables.
- [MCP tool reference](https://docs.clickwheel.fm/reference/mcp-tools.md): Every tool the clickwheel MCP server exposes.