Parson

Your music. Instantly.

Parson is a local-first music app for your own collection.

Choose a folder. Start listening.

Download · Docs · Releases

Start

Install Parson, create your account, and choose your music folder.

Desktop apps include everything needed to run your library.

Download

Get Windows, macOS and Linux packages from the latest release.

The server container is ghcr.io/parsonlabs/parson:latest. Versioned image tags are also published for pinned deployments.

Build provenance is included with the release.

Docker

services:
  parson:
    image: ghcr.io/parsonlabs/parson:latest
    network_mode: host
    volumes:
      - /path/to/parson-data:/Parson
      - /path/to/music:/music:ro
    restart: unless-stopped

Open http://localhost:1993, create your account, and choose /music.

Privacy

Parson does not upload analytics or crash reports.

Music, accounts, playlists, history, and recommendations stay on infrastructure you control. External requests are limited to services you use, such as lyrics, updates, and casting.

Privacy and security

Development

Requires Bun, Rust, Node.js, FFmpeg, and the native build toolchain for your platform.

bun install --frozen-lockfile
cargo run -p parson-music

Run the web app separately:

bun --filter parson-music-web dev

Development guide

Repository

• crates/parson-core — accounts, identities, and libraries
• crates/backend — server, indexer, storage, APIs, and discovery
• apps/web — web player
• apps/desktop — desktop packaging
• apps/site — website and docs

Security

Report vulnerabilities privately through GitHub Security Advisories.

Deployment guidance is in the privacy and security documentation.

License

GPL-3.0-only