Skip to main content

​
auth

Run the Music User Token authorization flow. Opens your browser to sign in with your Apple ID, then saves the token to ~/.clickwheel/.env. One-time per Mac and Apple ID; the token is long-lived but can be revoked. Examples

​
delete

Delete a library playlist from your Apple Music account. macOS-only; the deletion syncs to your other devices via iCloud Music Library. Deletes EVERY playlist matching the name, useful for clearing duplicates from failed pushes.
​
string
required
Apple Music library playlist name to delete.
​
boolean
Skip the confirmation prompt.

​
doctor

Probe Apple Music end-to-end (config, .p8, dev token, user token, storefront, iCloud Music Library state). Mirrors plex doctor. Examples

​
list

List every library playlist in your Apple Music account. Read-only. Use before apple pull to find the playlist you want. Manual and smart playlists both appear; smart ones come back with canEdit=false (we can pull them but you can’t push back).

​
match

Preview how a playlist’s tracks resolve to Apple Music song IDs. Read-only (creates nothing), but caches the matches so the next apple push is faster. Tracks below --min-confidence are flagged low-confidence for review before pushing. Examples
​
string
required
clickwheel playlist to match.
​
boolean
Ignore the cache and re-match every track.
​
number
default:"0.85"
Threshold between matched and low-confidence.

​
pull

Import an Apple Music library playlist into clickwheel’s local store. Tracks are matched against your library; unmatched rows are reported (usually files Apple has that clickwheel hasn’t scanned yet). Examples
​
string
required
Apple Music playlist to import.
​
boolean
Replace an existing clickwheel playlist with the same name.
​
number
default:"0.85"
Fuzzy-match threshold for unmatched cache entries.

​
push

Create a playlist in your Apple Music account from a clickwheel playlist. Low-confidence matches are skipped by default; pass --include-low (after a clickwheel apple match review) to include them. Examples
​
string
required
clickwheel playlist to push to Apple Music.
​
boolean
Ignore the cache and re-match every track.
​
number
default:"0.85"
Reject matches below this confidence.
​
boolean
Push low-confidence matches too (use after reviewing).
​
boolean
Skip the confirmation prompt.