wzrd-listen

Passive witness client for music playback. Observes what you're listening to locally, reports checkpoints to the TWZRD listen API, and finalizes sessions with a Merkle root.

No API keys. No Spotify login. Just proof.

Install

pip install wzrd-listen

Quick start

# Check setup
wzrd-listen doctor

# Witness live playback
wzrd-listen watch --summary

# Run a synthetic demo session
wzrd-listen demo --source spotify --track "Nujabes - Feather" --checkpoints 3 --summary

On first run, a device identity is created at ~/.config/wzrd-listen/device.json. This key is your identity - no account required.

Supported platforms

• macOS: Spotify, Music.app (via osascript)
• Linux: Any MPRIS player via playerctl (apt install playerctl)

What happens

1. wzrd-listen doctor checks your player and API reachability
2. wzrd-listen watch polls your active player, sends checkpoints to the listen API
3. Session finalizes with a Merkle root - a cryptographic proof of your listening
4. View your proof profile at https://twzrd.xyz/listen/{your-device-key}

Environment variables

Trust model

• Witness proof = trust anchor (local observation, Merkle tree)
• AI summary = product value (co-listener arc)
• Verifier verdict = fraud resistance
• On-chain mint = deferred until the event model stabilizes