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.1a24

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.1a24
File Size Uploaded
plyrfm-0.0.1a24.tar.gz 13.2 kB Details

Built distribution (wheel)

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

Total release size: 28.9 kB

Release files / plyrfm-0.0.1a24.tar.gz

Download URL plyrfm-0.0.1a24.tar.gz
Size 13.2 kB
Tags Source
SHA-256 checksum
How to use checksums
0bc9e8a212e5e1366126e8e702464d91222282df0e893b41de78ce39132fea20
BLAKE2b-256 checksum
How to use checksums
c3e21301aa9dc94773f8aa06a030198d1ce94fb66a9433ae6c36f08aaf71c918
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.1a24-py3-none-any.whl

Download URL plyrfm-0.0.1a24-py3-none-any.whl
Size 15.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bb2a6ecbd8430cf2e0329ae4e1fe5e0d3dac33c3f00eb3e216e246fbcf2d1806
BLAKE2b-256 checksum
How to use checksums
08d82a9791350c35cf8301f9a1bd12114d609644dc33b8fae29f4b857b695fac
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