Metadata-Version: 2.5
Name: rochtunes
Version: 0.2.0
Summary: Load a Rochtunes library onto an MP3 player
Requires-Python: >=3.11
Requires-Dist: mutagen>=1.47.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: requests>=2.32.0
Requires-Dist: yt-dlp>=2025.1.1
Description-Content-Type: text/markdown

# rochtunes

The local half of [Rochtunes](https://rochtunes.com), a collaborative private
music library builder. People add songs to a shared library on the web; a
library admin runs this CLI on a Mac to source those songs, tag them for the
device, and load them onto a plugged-in MP3 player -- including one playlist
per contributor, so everyone's additions are browsable on the player itself.

```
brew install ffmpeg
uv tool install rochtunes

rochtunes doctor        # check this machine can do a sync
rochtunes devices       # list volumes that look like a player
rochtunes sync <KEY>    # load the library onto the player
```

The key comes from your library's admin page. Rochtunes only ever adds files;
it never deletes anything from a device.

macOS only, for now. Libraries are invite-only, so this package is only
useful to library admins.
