# mpz

> Music player for large local collections. Native C++/Qt, 3-column folder-based UI, CUE sheets, lyrics (embedded, .lrc/.txt sidecar, or LRCLIB), built-in tag editor (since 2.0.8), MPRIS, and an experimental mpd client mode. Free and open source under GPL-3.0. Runs on Linux, macOS, and Windows.

mpz treats your folder structure as the library — there is 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 for 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 — single fetch, no link-following required

## Documentation

- [README](https://github.com/olegantonyan/mpz#readme): Project README — 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

- [omnipackage stable repositories](https://repositories.omnipackage.org/mpz/stable/install.html): Recommended Linux install for openSUSE, Debian, Fedora, Ubuntu, RedHat, Mageia, Arch, Manjaro
- [omnipackage unstable repositories](https://repositories.omnipackage.org/mpz/next/install.html): Builds from master branch
- [AUR (Qt6)](https://aur.archlinux.org/packages/mpz/): Arch Linux package, also available if you prefer it over the binary repositories
- [AUR (Qt5)](https://aur.archlinux.org/packages/mpz-qt5): Arch Linux package built against Qt5
- [GitHub releases](https://github.com/olegantonyan/mpz/releases): Windows installer and portable binaries (x64, native ARM64, and legacy 32-bit); macOS .dmg (unsigned — see README for 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