Parson Docs

Platform	Architecture	Download
Windows installer	x64	Parson_1.0.0_x64-setup.exe
Windows installer	ARM64	Parson_1.0.0_arm64-setup.exe
Linux AppImage	x64	Parson_1.0.0_x86_64.AppImage
Linux AppImage	ARM64	Parson_1.0.0_arm64.AppImage
Linux Debian package	x64	Parson_1.0.0_amd64.deb
Linux Debian package	ARM64	Parson_1.0.0_arm64.deb
macOS disk image	Intel x64	Parson_1.0.0_x64.dmg
macOS disk image	Apple Silicon	Parson_1.0.0_arm64.dmg

Requirements

App	Requirement
Parson for Windows	Windows 10 version 2004 (build 19041) or newer; Windows 11 supported
Parson for Linux	x64 or ARM64; glibc 2.35+ (Ubuntu 22.04+, Debian 12+, or equivalent)
Parson for macOS	macOS 12 Monterey or newer; Intel or Apple Silicon
Web player	A current browser that can reach the Parson host

Windows includes Electron's Chromium runtime, matching the Linux desktop rendering and audio surface. Some audio formats may need FFmpeg available to the server when they cannot be played directly by the client.

Install on Windows

Choose the x64 installer for Intel/AMD computers or ARM64 for Windows on ARM. Open the installer and follow the Windows installation prompt. The Windows app contains both the music server and player; no separate server install is needed.

Install on Linux

Download the AppImage for your architecture, make it executable, and run it:

chmod +x Parson_1.0.0_x86_64.AppImage
./Parson_1.0.0_x86_64.AppImage

The Debian package is available for systems that prefer package installation.

Install on macOS

Choose Apple Silicon for M-series Macs or Intel x64 for Intel Macs. Open the DMG, drag Parson to Applications, and open it. macOS may ask you to confirm opening an application downloaded outside the App Store.

Parson does not publish Android or iPhone packages. Those devices can use the web player in a current browser.

Update behavior

Updates do not replace your music or intentionally clear Parson data. Database migrations can make older application versions unable to read newer data; see Updates and migrations.

Uninstall

On Windows, uninstall Parson from Settings → Apps → Installed apps. On macOS, quit Parson and move it from Applications to the Trash. On Linux, remove the Debian package or delete the AppImage and its desktop integration. Your music files are never owned by Parson and remain where they are.

Application data remains so a reinstall can recover the library and accounts. Remove the platform-specific data directory below only when you intend to erase Parson's database, accounts, playlists, likes, history, lyrics cache, settings, logs, and cached artwork.

Application data

Default locations are:

Windows: %LOCALAPPDATA%\Parson
macOS:   ~/Library/Application Support/Parson
Linux:   ~/.local/share/Parson

Important subfolders are Database, Cache, Secrets, Logs, Discovery, and Updates. PARSON_DATA_DIR can move the whole data directory in advanced installations.

Download and install

Downloads