Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

plyrfm

python sdk for plyr.fm - music on atproto.

quickstart

requires uv. lists recent tracks:

uv run --with plyrfm python -c "
from plyrfm import PlyrClient

client = PlyrClient()
for t in client.tracks.list(limit=5):
    print(f'{t.id}: {t.title} by {t.artist}')
"

install

uv add plyrfm

usage

from plyrfm import PlyrClient

# public operations (no auth needed)
client = PlyrClient()
tracks = client.tracks.list()
track = client.tracks.get(42)

# authenticated operations
client = PlyrClient(token="your_token")
my_tracks = client.tracks.my()
client.tracks.upload("song.mp3", "My Song")
client.tracks.download(42)

CLI

# set token once
export PLYR_TOKEN="your_token"

# list public tracks
plyrfm tracks list

# list your tracks
plyrfm tracks my

# upload
plyrfm tracks upload track.mp3 "Song Title"

# download
plyrfm tracks download 42

auth

get a developer token at plyr.fm/settings#developer

See interface choices and the generated capability table. Downloads use the artist-policy endpoint; streaming access alone does not imply download permission.

Metadata

Release files for plyrfm 0.0.1a22

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plyrfm 0.0.1a22
File Size Uploaded
plyrfm-0.0.1a22.tar.gz 13.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for plyrfm 0.0.1a22
File Interpreter ABI Platform
plyrfm-0.0.1a22-py3-none-any.whl Python 3 none any Details

Total release size: 28.9 kB

Release files / plyrfm-0.0.1a22.tar.gz

Download URL plyrfm-0.0.1a22.tar.gz
Size 13.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f36e3f6ee74d4f17805329a995f16ea2cab768095933d8ac2e285450a13d1a9b
BLAKE2b-256 checksum
How to use checksums
59fa0b104b92c16068d1b9f52577c776db786ca2c950d9d1676f0cf427777004
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / plyrfm-0.0.1a22-py3-none-any.whl

Download URL plyrfm-0.0.1a22-py3-none-any.whl
Size 15.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
49a8d557abe624b96757f2c95aa9a970f1124ed10c6e0a449f5d907a484f6c5d
BLAKE2b-256 checksum
How to use checksums
2fffaa954457de4edc4567c211f4c0137de572849e2ce3e98dc59f49c8f2a44d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page