# mpz

> A folder player for large local music collections. Plays music straight from your folder structure. Native C++/Qt, 3-column folder-based UI, gapless playback (2.1.0), equalizer with 10-band and parametric modes (2.1.0), ReplayGain volume normalization, internet radio from m3u/m3u8/pls stream playlists plus a radio library (2.1.0), CUE sheets, cover art and lyrics (embedded, sidecar files, or opt-in online sources), tag editor (since 2.0.8), waveform seekbar, dynamic range meter in the foobar2000 DR format, editable keyboard shortcuts, OS media integration (MPRIS on Linux, SMTC on Windows, Now Playing on macOS), and an experimental mpd client mode. Free and open source under GPL-3.0. Runs on Linux, macOS and Windows.

mpz is a folder player: your folder structure is the library, with no global indexing step. Middle-clicking a folder in the directory tree creates a playlist from it. The UI has three columns: directory tree (library), playlists, and tracks of the selected playlist. The design is inspired by Foobar2000's "Album list", but is not an attempt to clone Foobar.

## Full content

- [llms-full.txt](https://mpz-player.org/llms-full.txt): Self-contained version of this page with the full feature list, install instructions and FAQ inlined, so a single fetch is enough

## Documentation

- [README](https://github.com/olegantonyan/mpz#readme): Project README with features, installation, configuration, lyrics, MPRIS, limitations
- [Changelog](https://github.com/olegantonyan/mpz/blob/master/CHANGELOG.md): Version history
- [mpd impedance mismatch](https://github.com/olegantonyan/mpz#mpd-impedance-mismatch): Caveats of mpz's mpd client mode

## Install

- [Stable native packages, x86_64](https://repositories.omnipackage.org/mpz/stable/install.html): Recommended Linux install for openSUSE, Debian, Fedora, Ubuntu, RedHat, Mageia, Arch, Manjaro
- [Stable native packages, aarch64](https://repositories.omnipackage.org/mpz/stable-aarch64/install.html): Same distros, native ARM64
- [Unstable native packages, x86_64](https://repositories.omnipackage.org/mpz/next/install.html): Builds from master
- [Unstable native packages, aarch64](https://repositories.omnipackage.org/mpz/next-aarch64/install.html): Builds from master, native ARM64
- [AUR](https://aur.archlinux.org/packages/mpz/): Arch Linux package
- [AppImage](https://github.com/olegantonyan/mpz/releases): Linux builds for x86_64 and aarch64; prefer the native packages if your distro is supported
- [Flathub](https://flathub.org/apps/org.mpz_player.mpz): Flatpak build (`flatpak install flathub org.mpz_player.mpz`) for any distro; prefer the native packages if your distro is supported
- [GitHub releases](https://github.com/olegantonyan/mpz/releases): Windows installer and portable binaries (x64, native ARM64, legacy 32-bit); macOS .dmg (unsigned, see the README for the Gatekeeper workaround); tagged source archives

## Source and feedback

- [Repository](https://github.com/olegantonyan/mpz): Source code on GitHub
- [Issues](https://github.com/olegantonyan/mpz/issues): Bug reports and feature requests
- [Author](https://github.com/olegantonyan): Oleg Antonyan

## Optional

- [Screenshots](https://mpz-player.org/#library): Landing page section with screenshots across desktops (KDE Breeze Dark/Light, Ubuntu, Windows 10, macOS)
- [License](https://www.gnu.org/licenses/gpl-3.0.html): GNU General Public License v3