Documentation Index
Fetch the complete documentation index at: https://clickwheel.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Run clickwheel --help (or clickwheel <command> --help) for the same
information in your terminal.
clickwheel apple
Apple Music integration commands.
clickwheel delete
Delete a saved playlist.
| Name | Kind | Description | Default |
|---|
playlist_name | option | Playlist to delete | |
--force, -f | option | Skip confirmation | |
clickwheel diff
Preview changes before syncing to your iPod.
| Name | Kind | Description | Default |
|---|
playlist_name | option | Playlist to diff against iPod | ipod |
--no-scan | option | Skip automatic library scan | |
clickwheel edit
Add or remove artists from a playlist.
| Name | Kind | Description | Default |
|---|
playlist_name | option | Playlist to edit | ipod |
--add, -a | option | Artist to add | [] |
--remove, -r | option | Artist to remove | [] |
--description, -d | option | Set the playlist description | “ |
--no-scan | option | Skip automatic library scan | |
clickwheel eject
Safely disconnect the iPod.
clickwheel fix
Fill in missing album art, genres, and other track details.
| Name | Kind | Description | Default |
|---|
--dry-run | option | Show what would be done without making changes | |
--refresh-mb | option | Re-query MusicBrainz, ignoring the cache. Use after a known-bad cached match. | |
--refresh-genres | option | Re-query Last.fm for genres, ignoring the cache. | |
artist | option | Artist folder name to target (default: entire library) | |
clickwheel heal
Drop playlist references to tracks no longer on disk.
Uses the missing-since flag set by clickwheel scan. Run a scan
first if you want freshness; pass —no-scan to skip the autoscan
if you’ve already scanned recently.
| Name | Kind | Description | Default |
|---|
playlist_name | option | Playlist to heal | |
--no-scan | option | Skip automatic library scan | |
clickwheel ls
Show what’s on your iPod.
clickwheel playlist
Show your saved playlists.
| Name | Kind | Description | Default |
|---|
name | option | Playlist name to show details | |
clickwheel plex
Plex integration commands.
clickwheel scan
Scan your music library and check for missing info.
| Name | Kind | Description | Default |
|---|
--full, -f | option | Rescan everything from scratch | |
--stats | option | Show library stats without scanning again | |
clickwheel scrobble
Submit your recent iPod listens to Last.fm.
| Name | Kind | Description | Default |
|---|
--dry-run | option | Show plays without submitting | |
--status | option | Show Last.fm profile info | |
--auth | option | Authorize clickwheel with your Last.fm account | |
clickwheel select
Pick artists and albums for your iPod.
| Name | Kind | Description | Default |
|---|
--name, -n | option | Playlist name | ipod |
--description, -d | option | Optional playlist description | “ |
--no-scan | option | Skip automatic library scan | |
clickwheel sync
Send your playlist to the iPod.
| Name | Kind | Description | Default |
|---|
playlist_name | option | Playlist to sync | ipod |
--dry-run | option | Show what would change without doing it | |
--no-scan | option | Skip automatic library scan | |
clickwheel sync-plex
Push playlist(s) to your Plex music library.
| Name | Kind | Description | Default |
|---|
playlist_name | option | Playlist to push to Plex. Omit with —all to push every playlist. | |
--all | option | Push every clickwheel playlist to Plex. | |
--no-scan | option | Skip automatic library scan. | |
