beets-ibroadcast 0.1.0

('iBroadcast plugin for Beets',)

Beets iBroadcast Plugin

This plugin lets you upload music from your beets library to the iBroadcast streaming service.

Setup

1. Install the plugin into your local environment with:

   pip install beets-ibroadcast
   

2. Enable the plugin by adding ibroadcast to your plugins: section in your beets config file.

3. Configure your iBroadcast credentials:

   ibroadcast:
     username: <your email address>
     password: <your password>
   

   Be sure to put quotes around your password if it includes any special characters.

Usage

beet ibroadcast <query>

All tracks matching the query will be uploaded as needed:

• Tracks previously uploaded by beets-ibroadcast will already have ib_uploadtime and ib_trackid flexible attributes attached; if the track's mtime is older than its ib_uploadtime, the track is assumed to be up to date, and the upload is skipped.

• For tracks where mtime is newer, the track is uploaded again, and the previous track ID is trashed. As such, obsolete previous versions of tracks will appear in your iBroadcast trash until it is emptied.

• Regardless: before uploading, the track's MD5 checksum is computed, and if the server already has a track with that checksum, the upload is skipped. As such, if you upload tracks with a different uploader than beets-ibroadcast, they will still be skipped (although as of this writing, beets-ibroadcast will read such files to compute their checksums every time they match a query, which will impact performance).