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

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

Built distribution (wheel)

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

Total release size: 28.9 kB

Release files / plyrfm-0.0.1a23.tar.gz

Download URL plyrfm-0.0.1a23.tar.gz
Size 13.2 kB
Tags Source
SHA-256 checksum
How to use checksums
84ec11759350f146179fd26d00c1a82a250d9a586b74db654546be41bde4cdfe
BLAKE2b-256 checksum
How to use checksums
46fce5c08495e417d34263016db7db0b095a8bf4c3b8aad46e6a712189977284
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.1a23-py3-none-any.whl

Download URL plyrfm-0.0.1a23-py3-none-any.whl
Size 15.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2af00e80297f0f2bb127280d6bccf7a9502952554985f9b2f29028bf3a82093d
BLAKE2b-256 checksum
How to use checksums
700a0da7ac8f059161e47fe77f2898c3e3b5f3512f88950d9531ee82f899663c
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