Download and install
Downloads, requirements, updates, removal, and application data.
Downloads
Choose the file for your platform and architecture.
Download the latest release and choose the installer for your platform and architecture.
View all releases.
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 13 Ventura 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_*_x86_64.AppImage
./Parson_*_x86_64.AppImageThe 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.
Phones and tablets can use the web player.
Update behaviour
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/ParsonImportant subfolders are Database, Cache, Secrets, Logs, Discovery, and Updates. PARSON_DATA_DIR can move the whole data directory in advanced installations.