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

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

Built distribution (wheel)

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

Total release size: 29.5 kB

Release files / plyrfm-0.0.1a25.tar.gz

Download URL plyrfm-0.0.1a25.tar.gz
Size 13.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a4d41d712fdd33e2f6d31104cec23ef0813cad4070c2f9af1b7e63c7b428f751
BLAKE2b-256 checksum
How to use checksums
84b7c321a3b8e92a8dcaa15ccf3024b1f1b0fa49bb28b43a412d826fce71a97c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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.1a25-py3-none-any.whl

Download URL plyrfm-0.0.1a25-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7fcc2b979b4934c0fcb3c5429f693642de974cd718f3dea3356ddbe344636416
BLAKE2b-256 checksum
How to use checksums
094abde82b68d27f4c83e2f970413aed174af84709c8c3560bae8ed33fe50acb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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