Skip to main content

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.

Try asking Claude
  • “What’s on my iPod, and how full is it?”
  • “Put all my Weezer on the iPod.”
  • “Sync my road-trip playlist to the iPod, then eject it.”

add_artist_to_ipod

Push every track by an artist to the iPod’s library, no playlist artifact.
artist
string
required
Artist name (exact match, case-sensitive).

add_tracks_to_ipod

Push specific tracks to the iPod’s library WITHOUT creating a playlist on the device. Tracks land in the main library and are browsable by artist/album.
paths
string[]
required
Absolute paths (from the indexed library) of tracks to add. Use list_tracks_by_album / search_tracks to get paths. Never invent them.

eject_ipod

Safely unmount the iPod via diskutil eject. Idempotent: if the iPod is already unmounted, returns {"ejected": False, "already_unmounted": True} instead of raising. Classic iPods often auto-disconnect after a sync, so it may already be gone; that’s expected, so tell the user it’s safe to unplug.

get_ipod_contents

High-level snapshot of what’s on the iPod: capacity, used/free space, track/artist/album counts, and the top 25 artists by track count. Does NOT return the full track list. Use list_ipod_tracks to page through tracks (optionally filtered by artist).

list_ipod_playlists

List the playlists currently on the iPod (the ones visible under Music → Playlists on the device).

list_ipod_tracks

Paginated list of tracks on the iPod, optionally filtered by artist. Each track is the chat-friendly slice: artist, title, album, size in bytes. For the full per-track payload, use the CLI.
artist
any
Optional artist filter (exact match). Omit to page through all tracks.
limit
integer
default:"50"
Max tracks to return.
offset
integer
Pagination offset (0 = first page).

remove_artist_from_ipod

Drop every track by an artist from the iPod, in one shot.
artist
string
required
Artist name to drop from the iPod. Matched via canonical lead-artist rollup (album_artist-first), so e.g. removing ‘Taylor Swift’ also drops ‘Taylor Swift / HAIM’ tracks.

remove_ipod_playlist

Remove a playlist from the iPod (Music → Playlists). The playlist’s tracks are NOT deleted. They stay in the iPod’s main library, browsable by artist/album. Only the playlist artifact goes away.
name
string
required
Name of the iPod playlist to remove.

remove_tracks_from_ipod

Remove specific tracks from the iPod. Drops them from the iTunesDB AND deletes the underlying audio files from the device.
paths
string[]
required
Absolute paths (from the indexed library) of tracks to remove from the iPod. Get these via list_tracks_by_album or search_tracks. Paths that aren’t on the iPod are reported back as unmatched, not an error.

sync_playlist_to_ipod

Push a saved playlist (the clickwheel-side draft) to the iPod AND create/update the corresponding playlist on the device under Music → Playlists. Copies any missing tracks first.
playlist
string
required
Saved playlist name to sync.
on_conflict
any
How to resolve a same-name playlist already on the iPod. Omit on the first call; if a conflict exists, this tool returns a structured error so you can ask the user to pick one of: ‘merge’ (combine tracks), ‘replace’ (overwrite contents), ‘rename’ (use target_name for a new playlist name).
target_name
any
Required when on_conflict=‘rename’. The new iPod-side playlist name to use instead of the clickwheel name.