QMPlay2 - Qt Media Player 2

QMPlay2 is a video and audio player. It can play all formats supported by FFmpeg, libmodplug (including J2B and SFX). It also supports Audio CD, raw files, Rayman 2 music and chiptunes. It contains YouTube and MyFreeMP3 browser.

Table of Contents

• Installation
• YouTube
• Spherical view
• ALSA
• Hardware acceleration
• Deinterlacing
• Hidden features
• Multimedia keys
• Installation from sources
• Building package RPM, DEB or any other
• Other information

Installation

Easy installation on Windows

• Download the Windows installer.

Easy installation on Linux (AppImage)

• Download the Linux AppImage.

Easy installation on Arch Linux / Manjaro Linux

• Install AUR client (e.g. yay),
• run the following command:

  yay -S qmplay2

Easy installation on openSUSE

• Don't mix FFmpeg from different repositories!
• Run the following commands: ##### openSUSE Leap 15.3

  sudo zypper ar https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.3 Packman
  sudo zypper ar http://download.opensuse.org/repositories/multimedia:/apps/openSUSE_Leap_15.3
  sudo zypper dup --allow-vendor-change --from "Packman"
  sudo zypper dup --allow-vendor-change --from http://download.opensuse.org/repositories/multimedia:/apps/openSUSE_Leap_15.3
  sudo zypper in QMPlay2
  

  ##### openSUSE Tumbleweed

  sudo zypper ar https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Tumbleweed Packman
  sudo zypper dup --allow-vendor-change --from "Packman"
  sudo zypper in QMPlay2
  

  #### Easy installation on Fedora
• Run the following commands:

  sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
  sudo dnf groupupdate core
  sudo dnf update
  sudo dnf groupupdate multimedia --setop="install_weak_deps=False" --exclude=PackageKit-gstreamer-plugin
  sudo dnf groupupdate sound-and-video
  sudo dnf install qmplay2
  

Easy installation on Gentoo Linux

• Run the following command:

  emerge --ask media-video/qmplay2

YouTube

You can change the default audio and video quality of YouTube contents. Click on the "Settings" icon on the left of the search bar, change the order of audio and/or video quality priorities and apply changes. If the chosen quality can't be found on YouTube content, QMPlay2 will try using the next entry on the quality list.

YouTube videos don't work without external "youtube-dl" software, so QMPlay2 will download it automatically. You can remove downloaded "youtube-dl" from settings.

Windows

• Make sure that antivirus or firewall doesn't block "youtube-dl" and doesn't block executing external applications!

Spherical view

QMPlay2 supports spherical view on OpenGL and Vulkan video outputs. You can watch e.g. YouTube spherical videos by pressing "Ctrl+3". You can also enable it from the menu: "Playback->Video filters->Spherical view".

ALSA

If you are using your own ALSA configuration

asound.conf

.asoundrc

defaults.namehint.!showall on

Hardware acceleration

QMPlay2 supports hardware video decoding: CUVID (NVIDIA only), DXVA2 (Windows Vista and higher), D3D11VA (Vulkan, Windows 8 and higher) VDPAU/VA-API (X11 for VDPAU, Linux/BSD only) and VideoToolBox (macOS only). Hardware acceleration is disabled by default, but you can enable it in "Settings->Playback settings": - move hardware accelerated decoder on decoders list to the top, - apply settings.

Hardware acceleration important information:

• CUVID, DXVA2, VDPAU and VA-API use OpenGL video output, so OpenGL features are available, but CPU filters won't work.
• CUVID. D3D11VA and VA-API use Vulkan video output, so Vulkan features are available, but CPU filters won't work.
• DXVA2 requires "WGLNVDX_interop" extension.
• DXVA2 and VDPAU don't work with Vulkan.
• VDPAU, VA-API, CUVID and DXVA2 have its own deinterlacing filters. Their settings are available in "Settings->Video filters".
• VA-API on Vulkan uses its own deinterlacing filter only on Intel drivers.
• H.264 lossless movies (CRF 0 or QP 0) might not be properly decoded via VDPAU and VA-API.
• VideoToolBox doesn't support deinterlacing.

VA-API + OpenGL information:

VA-API + OpenGL uses EGL for OpenGL context creation. On X11 QMPlay2 tries to detect if EGL can be used, but the detection can fail. In this case you can try do it manually:

export QT_XCB_GL_INTEGRATION=xcb_glx

export QMPLAY2_EGL_CARD_FILE_PATH=/dev/dri/card1

Deinterlacing

Video interlacing is automatically detected by QMPlay2. Go to "Settings->Video filters" for more options. If you have fast CPU (or low video resolution), you can use "Yadif 2x" deinterlacing filter for better quality.

You can enable deinterlacing filter on non-interlaced video if necessary (some interlaced videos may not have interlacing data), but remember to revert this setting on any other video! Otherwise the video quality and performance will be worse!

Hardware-accelerated video decoding uses its own video filtering, so the CPU deinterlacing method (e.g. "Yadif 2x") does nothing in this case. Of course you can adjust other deinterlacing settings in case of hardware acceleration.

Vulkan renderer has Yadif deinterlacing filter which is used by default for CPU decoded videos. You can change this behavior in Vulkan renderer settings. Moreover, Yadif Vulkan filter is used for hardware-decoded videos.

Chroma plane if pixel format is not YUV420 when XVideo or DirectDraw is used as video output may not be properly deinterlaced.

Hidden features

Audio balance

Right click on volume slider and select "Split channels".

Last.fm scrobbling

Go to "Options->Modules settings" and click "Extensions" on the list. Find "LastFM" group box, select "Scrobble", type your login and password and then press "Apply".

Control files

Empty files in

share

QMPlay2.exe

portable

noautoupdates

Still images

Go to "Options->settings" and check "Read and display still images".

Custom user agent

You can specify a

CustomUserAgent

QMPlay2.ini

General

Single instance

You can force single instance for QMPlay2: set "Allow only one instance" in "Settings->General settings".

Multimedia keys

In Windows and macOS, multimedia keys should work automatically.

In Linux/BSD, you must associate keys with commands: - using QMPlay2 binary, see:

QMPlay2 -h

dbus-send --print-reply --dest=org.mpris.MediaPlayer2.QMPlay2 /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.PlayPause

dbus-send --print-reply --dest=org.mpris.MediaPlayer2.QMPlay2 /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Next

dbus-send --print-reply --dest=org.mpris.MediaPlayer2.QMPlay2 /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Previous

dbus-send --print-reply --dest=org.mpris.MediaPlayer2.QMPlay2 /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Stop

Installation from sources

Don't forget to update submodules:

git submodule update --init

CMake requirements

For CMake build be sure that you have CMake 3.9 or higher.

You need devel packages:

Necessary:

• Qt5 >= 5.10:
  • Qt5DBus - Linux/BSD only,
  • Qt5Svg - for SVG icons,
  • Qt5Qml - for MediaBrowser,
  • Qt5WinExtras - for Windows,
• FFmpeg >= 4.0:
  • libavformat - requires OpenSSL or GnuTLS for https support,
  • libavcodec - for FFmpeg module only,
  • libswscale,
  • libavutil,
  • libswresample,
  • libavdevice - for FFmpeg module only, optional (enabled on Linux as default),

Important:

• TagLib >= 1.9,
• libass - for OSD and non-graphical subtitles.

For modules (some of them can be automatically disabled if not found):

• FFmpeg (necessary module): libva (VA-API) and libvdpau (VDPAU, X11 only),
• Chiptune: libgme (kode54 version is recommended) and libsidplayfp,
• DirectX (Windows only): DirectDraw SDK (included in mingw-w64),
• AudioCD: libcdio and libcddb,
• ALSA (Linux only): libasound,
• PulseAudio - libpulse-simple,
• PortAudio: portaudio (v19),
• XVideo (X11 only): libxv.

Dependencies:

Arch Linux / Manjaro Linux dependencies

• Common packages:

  $ sudo pacman -S cmake make gcc pkg-config ffmpeg libass libva libxv alsa-lib libcdio taglib libcddb libpulse libgme libsidplayfp qt5-base qt5-tools
  

Running the compilation for Linux/BSD using CMake:

• Install all needed packages and dependencies (in devel version) using package manager or compile it from sources.
• You can use

  cmake-gui

  for graphical configuration. Otherwise follow the instructions below:
  • create a "build" directory and go to it:

    mkdir build && cd build

    ,
  • run CMake (also you can run with arguments which you want):

    cmake ..

    ,
  • check the summary - which features are enabled - you can set/force them manually,
  • if CMake finishes without errors, run:

    make -j8

    (replace 8 with numbers of CPU threads),
  • if compiling finishes without errors, install it:

    sudo make -j8 install

    .

CMake options (option - default value: description): - CMake options and the default settings: -

CMAKE_INSTALL_PREFIX

/usr/local

CMAKE_BUILD_TYPE

Release

LANGUAGES

All

SOLID_ACTIONS_INSTALL_PATH

SET_INSTALL_RPATH

ON

OFF

USE_FFMPEG

USE_FFMPEG_VAAPI

USE_FFMPEG_VDPAU

USE_FFMPEG_AVDEVICE

OFF

USE_INPUTS

USE_MODPLUG

USE_EXTENSIONS

USE_MPRIS2

ON

USE_VISUALIZATIONS

USE_AUDIOFILTERS

USE_VIDEOFILTERS

USE_OPENGL

ON

USE_VULKAN

USE_GLSLC

OFF

USE_AUDIOCD

USE_ALSA

ON

USE_PORTAUDIO

ON

USE_PULSEAUDIO

OFF

USE_XVIDEO

USE_CHIPTUNE_GME

USE_CHIPTUNE_SID

USE_TAGLIB

ON

USE_CMD

OFF

USE_LASTFM

ON

USE_LIBASS

ON

USE_CUVID

ON

USE_LYRICS

ON

USE_MEDIABROWSER

ON

USE_RADIO

ON

USE_YOUTUBE

ON

USE_ASAN

OFF

USE_UBSAN

OFF

USE_LINK_TIME_OPTIMIZATION

OFF

USE_GIT_VERSION

ON

USE_UPDATES

ON

FIND_HWACCEL_DRIVERS_PATH

OFF

Using other Qt installation of CMake: -

Qt5Widgets_DIR

~/qtbase/lib/cmake/Qt5Widgets

Qt5DBus_DIR

~/qtbase/lib/cmake/Qt5DBus

Qt5LinguistTools_DIR

~/qtbase/lib/cmake/Qt5LinguistTools

Qt5Svg_DIR

~/qtbase/lib/cmake/Qt5Svg

Qt5Qml_DIR

~/qtbase/lib/cmake/Qt5Qml

Every CMake option must be prepended with

-D

=

You can strip binaries during installation to save disk space:

sudo make -j8 install/strip

Example commands (execute it in QMPlay2 directory with source code):

• Simple installation (rely on autodetection,

  strip

  reduces size, but it makes debugging unavailable):

$ mkdir build
$ cd build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr
$ make -j8
$ sudo make -j8 install/strip

• Use manually-specified install prefix, disable SID, use Polish language only and use manually-specified Solid actions path:

$ mkdir build
$ cd build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DUSE_CHIPTUNE_SID=OFF -DLANGUAGES="pl" -DSOLID_ACTIONS_INSTALL_PATH="/usr/share/solid/actions"
$ make -j8
$ sudo make -j8 install

• Update icon theme, mime and desktop database (replace

  /usr/share/

  by your install prefix path):

$ sudo update-desktop-database
$ sudo update-mime-database /usr/share/mime
$ sudo gtk-update-icon-cache /usr/share/icons/hicolor

• Uninstallation (in

  build

  directory):

$ sudo make uninstall

macOS:

• Install Brew and developer command line tools.
• Download and install Qt5 for macOS (ignore errors about missing XCode if any).
• Download and install CMake for macOS:
  • create symlink for

    cmake

    CLI (from Bundle) to

    /usr/local/bin

    .
• Install

  pkg-config

  and all dependencies from Brew.
  • you can also compile them manually (especially

    libass

    ,

    ffmpeg

    (w/o most encoders),

    fribidi

    (w/o

    glib

    ) and

    libsidplayfp

    ).
• Set missing directories for dependencies (QtCreator or CMake GUI are recommended):
  • set install prefix e.g. to Desktop directory (for Bundle),
  • install via

    make install

    - this creates a Bundle.

Windows (cross-compilation):

• Install all required MinGW packages (I recommend AUR MinGW packages).
• Some libraries are incompatible, use unneeded dependencies or don't exist in repository - you should built them on your own.
• Run

  cmake

  from cross-compilation toolchain.

Other information for Windows

• You can compile QMPlay2 on Windows host, but you must prepare toolchain for your own (also with CMake advanced options for libraries and paths):

  • CMAKE_LIBRARY_PATH

    - where to find QMPlay2 dependency libraries,

  • CMAKE_INCLUDE_PATH

    - where to find QMPlay2 dependency includes,

  • CUSTOM_*_LIBRARIES

    - additional custom libraries for linker (useful for static linking),
• I use my own PKGBUILDs for many MinGW libraries.
• Visual Studio can't compile QMPlay2.

Building package RPM, DEB or any other

You can look at Arch Linux PKGBUILD.

Other information

• QMPlay2 contains modified libmodplug sources which are used by Modplug module.
• QMPlay2 uses Concept icons created by Alexey Varfolomeev.