Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/olegantonyan/mpz
Music player for big local collections
https://github.com/olegantonyan/mpz
audio audio-player linux linux-app linux-desktop linux-desktop-app multimedia music music-player music-player-application player qt qt-gui qt5 qt6 qtmultimedia
Last synced: about 1 month ago
JSON representation
Music player for big local collections
- Host: GitHub
- URL: https://github.com/olegantonyan/mpz
- Owner: olegantonyan
- License: other
- Created: 2019-09-16T19:10:58.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-14T05:50:14.000Z (2 months ago)
- Last Synced: 2024-09-29T07:42:03.028Z (about 2 months ago)
- Topics: audio, audio-player, linux, linux-app, linux-desktop, linux-desktop-app, multimedia, music, music-player, music-player-application, player, qt, qt-gui, qt5, qt6, qtmultimedia
- Language: C++
- Homepage: https://mpz-player.org/
- Size: 32.1 MB
- Stars: 86
- Watchers: 4
- Forks: 2
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: license.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://opensource.org/licenses/)
[](https://build.opensuse.org/package/show/home:oleg_antonyan/mpz)
[](https://web.omnipackage.org/oleg/mpz/install)
# Music player for big local collections
If you like organizing 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 the 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 playing music you have on your hard drive), "big" means it's big enough so managing it becomes hard. Radio streaming also supported.
## 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](https://kdeconnect.kde.org/));
- 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.
Starting at Qt 6.4, QtMultimedia supports ffmpeg backend on Linux. You can enable it via environment variable QT_MEDIA_BACKEND: `QT_MEDIA_BACKEND=ffmpeg mpz`.
NOTE: currently on openSUSE Tumbleweed they seem to be using ffmpeg by default and this may cause issues. You can switch to gstreamer via the same environment variable `QT_MEDIA_BACKEND=gstreamer mpz`
## 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: https://aur.archlinux.org/packages/mpz/
```
git clone https://aur.archlinux.org/mpz.git
cd mpz
makepkg -si
```
For Qt5 version use this package: https://aur.archlinux.org/packages/mpz-qt5
```
git clone https://aur.archlinux.org/mpz-qt5.git
cd mpz-qt5
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 for Qt5 on and qt6-base-common-devel, qt6-multimedia-devel, qt6-widgets-devel, qt6-concurrent-devel for Qt6 openSUSE).
Packages' names may differ in different distros. Both Qt6 and Qt5 are supported.
```
git clone [email protected]:olegantonyan/mpz.git
cd mpz
mkdir build
cd build
qmake6 CONFIG+=release .. # use qmake-qt5 instead of qmake6 for Qt5
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
qmake6 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 your OS from automatic sleep while playing (on 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;
- `playlist_row_height` in `global.yml` - sets playlist's row height in pixels, by default it comes from your desktop theme, but in KDE Plasma 5.27 this height was increased for no apparent reason, can be useful in other DEs;
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](https://github.com/olegantonyan/mpz/blob/master/CHANGELOG.md)