Music player for big local collections

If you like to organize your music in folders, then this player might be for you. It doesn't try to index all the files into a library, but rather treats your files and folders as a library and provides a convenient way to create playlists directly from folders. Similar to Foobar2000's Album List, but it's not an attempt to clone.

More screenshots here: https://mpz-player.org

Why?

In about 15 years author couldn't find a suitable player for Linux. Foobar2000 works in Wine, but this solution is not perfect either. This player is an attempt to create the "perfect" player for the author. It doesn't have anything "breakthrough", it just gets the job done. The main feature is 3-columns UI and the way you manage playlists. Chose library folders, middle-click on a folder and a playlist will be created from this folder.

Why "big local collections"? "Local" opposed to streaming services (which are fine, but this player's goal is to play music you own, not rent), "big" means it's big enough so managing it becomes hard.

Features

• 3-columns UI which allows you to quickly create playlists from folders and switch between playlists;
• Built with C++/Qt - fast and responsive native UI;
• Supports internet radio in m3u and pls playlists formats;
• Supports CUE sheets;
• Supports MPRIS on Linux for remote control (for example, via KDE Connect);
• Configuration in 2 yaml files: one for global (portable between computers) and one local (for settings specific to the current installation).

Limitations

• Uses external codecs installed on your OS (through QtMultimedia, using GStreamer backend on Linux);
• Lacks some "expected" features like tracks rearranging within playlist;
• Global hotkeys don't work in Wayland.

Installation

openSUSE, Debian, Fedora, Ubuntu, CentOS, Mageia

Use Open Build Service repositories: https://software.opensuse.org//download.html?project=home%3Aoleg_antonyan&package=mpz

Arch

Use AUR package (Qt5): https://aur.archlinux.org/packages/mpz/

git clone https://aur.archlinux.org/mpz.git
cd mpz
makepkg -si

For Qt6 version use this package: https://aur.archlinux.org/packages/mpz-qt6

git clone https://aur.archlinux.org/mpz-qt6.git
cd mpz-qt6
makepkg -si

Windows

Grab installer or portable "dynamic" binary from releases page: https://github.com/olegantonyan/mpz/releases/

From sources

Dependencies: gcc, make, qt development headers (libqt5-qtbase-devel libqt5-qtmultimedia-devel libqt5-qtx11extras-devel). Packages' names may differ in different distros. Both Qt5 and Qt6 are supported.

git clone [email protected]:olegantonyan/mpz.git
cd mpz
mkdir build
cd build
qmake-qt5 CONFIG+=release .. # use qmake6 instead of qmake-qt5 for Qt6
make -j`nproc`
# now you now use app/mpz binary directly
# optionally, install to /usr:
sudo make install

You can also link against shared libraries Taglib and/or Yaml-cpp installed on your OS instead of using vendored statically compiled versions. To do this you have to add DEFINES+=USE_SYSTEM_TAGLIB DEFINES+=USE_SYSTEM_YAMLCPP to qmake cli.

git clone [email protected]:olegantonyan/mpz.git
cd mpz
mkdir build
cd build
qmake-qt5 CONFIG+=release DEFINES+=USE_SYSTEM_TAGLIB DEFINES+=USE_SYSTEM_YAMLCPP ..
make -j`nproc`
# now you now use app/mpz binary directly
# optionally, install to /usr:
sudo make install

Configuration

The default config location on Linux is ~/.config/mpz, on Windows - C:/Users/$USERNAME/AppData/Local/mpz/mpz. There are 2 files:

• local.yml - for the settings specific to this computer, like windows' sizes, playlists, etc;
• global.yml - for portable settings that make sense to share between computers.

Some config options can be changed only by editing config files:

• inhibit_sleep_while_playing in global.yml - when true player will prevent you OS from automatic sleep while playing (only Linux, requires systemd-inhibit);
• stream_buffer_size in global.yml - minimal stream buffer size in bytes. The default is 128KB;
• single_instance in global.yml - when true the player will reuse 1 instance, launching another instance with files as command line arguments will send these files to running instance as a new playlist;
• single_instance_ipc_port in global.yml - single instance functionality uses TCP socket, this option allows you to specify a port;
• playback_log_size in global.yml - max size of playback log, default is 100;
• columns_config in global.yml - configure columns in playlist section, more on this below;

If you messed up any of the config opions you can remove it completly (or even remove the whole file) and it will reset to default.

Columns config

You can change th default columns in the playlist view via columns_config option in global.yml file.

This config option does not (yet) have UI to change it so you have to edit config file. The defaults are:

columns_config:
  - align: left
    field: artist
    stretch: false
    width_percent: 28
  - align: left
    field: album
    stretch: false
    width_percent: 28
  - align: left
    field: title
    stretch: false
    width_percent: 28
  - align: right
    field: year
    stretch: false
    width_percent: 5
  - align: right
    field: length
    stretch: true
    width_percent: 0

Available fields: artist, album, title, year, length, path, url, sample_rate, bitrate, channels, track_number, format, filename.

Availble alignments: left, right.

The sum of width_percent of all columns must add up to 100 or below. Sometimes it has to be below 100 to get rid of horizontal scroll, this may happen due to padding and few extra pixels in you desktop theme.

stretch will stretch the column to fit the window width to the right. It's advised to have the last column stretched and the sum of all width_percent below 100, but you can experiment with it and see how looks on your desktop.

Changelog