Skip to content

Repository files navigation

Parson

Your music. Instantly.

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

Choose a folder. Start listening.

Parson

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

Releases

Packages

Used by

Contributors

Languages