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

Platform	Available packages
Windows	x64 installer · ARM64 installer
Linux x64	AppImage · Debian package
Linux ARM64	AppImage · Debian package
macOS	Intel DMG · Apple Silicon DMG
Server	ghcr.io/parsonlabs/parson:1.0.0

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