plyrfm#

python SDK and CLI for plyr.fm - available on PyPI and GitHub.

installation#

# run directly
uvx plyrfm --help

# or install as a tool
uv tool install plyrfm

# or as a dependency (SDK + CLI)
uv add plyrfm

authentication#

some operations work without auth (listing public tracks, getting a track by ID).

for authenticated operations:

1. go to plyr.fm/portal -> "your data" -> "developer tokens"
2. create a token
3. export PLYR_TOKEN="your_token"

CLI#

# public (no auth)
plyrfm list                        # list all tracks

# authenticated
plyrfm my-tracks                   # list your tracks
plyrfm upload track.mp3 "My Song"  # upload
plyrfm download 42 -o song.mp3     # download
plyrfm delete 42 -y                # delete
plyrfm me                          # check auth

use staging API:

PLYR_API_URL=https://api-stg.plyr.fm plyrfm list

SDK#

from plyrfm import PlyrClient, AsyncPlyrClient

# public operations (no auth)
client = PlyrClient()
tracks = client.list_tracks()
track = client.get_track(42)

# authenticated operations
client = PlyrClient(token="your_token")  # or set PLYR_TOKEN
my_tracks = client.my_tracks()
result = client.upload("song.mp3", "My Song")
client.delete(result.track_id)

async:

async with AsyncPlyrClient(token="your_token") as client:
    tracks = await client.list_tracks()
    await client.upload("song.mp3", "My Song")