Skip to main content

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.

clickwheel reads play counts off the iPod and submits them to Last.fm.

​
First-time setup

clickwheel scrobble --auth
This walks you through authorizing clickwheel with your Last.fm account. Add your API credentials to ~/.clickwheel/config.yaml — see Configuration.

​
Submit listens

clickwheel scrobble
clickwheel pulls recent plays from the iPod and submits them, caching what’s already been sent so you don’t double-scrobble. From the MCP server, the get_pending_scrobbles and submit_scrobbles tools do the same (with a dry_run option).
Scrobble before a big re-sync so play history isn’t lost when tracks change.