How to Install QMPlay2 on Linux Mint 21/20

QMPlay2 is an open-source multimedia player designed to provide a simple and feature-filled way to enjoy all media types in one place. Unlike VLC Media Player, QMPlay2 does not require extra plugins or libraries; its features are built and made available from the program’s modern GUI and inbuilt modules.

The following tutorial will demonstrate how to install QMPlay2 on Linux Mint 21 or Linux Mint 20 using a LaunchPAD PPA dedicated to QMPlay2 or Flatpak with a Flathub repository.

Update Linux Mint – Upgrade System Packages

Before you begin, run an update on your system to ensure all packages are up-to-date to avoid any conflicts during the installation.

sudo apt update

Optionally, you can list the updates for users who require review or are curious.

sudo apt --list upgradable

Proceed to upgrade any outdated packages using the following command.

sudo apt upgrade

Method 1: Install QMPlay2 with LaunchPAD PPA

The first method in installing QMPlay2 is to import the QMPlay2 LaunchPAD PPA maintained by tomtomtom. Before proceeding, run the install command below for packages. These are most likely installed but run the command to be safe.

sudo apt install dirmngr lsb-release ca-certificates software-properties-common apt-transport-https -y

For users who have not previously imported a GPG key from the Ubuntu keyserver, the command line terminal will often have issues importing GPG keys from LaunchPAD PPAs because the directories are not created.

sudo gpg --list-keys

Example output:

gpg: directory '/root/.gnupg' created
gpg: keybox '/root/.gnupg/pubring.kbx' created
gpg: /root/.gnupg/trustdb.gpg: trustdb created

This can be skipped, but if you encounter an issue, just run the command and re-try.

The next task is to import the GPG key needed.

sudo gpg --no-default-keyring --keyring /usr/share/keyrings/qmplay2.gpg --keyserver --recv-keys CEC312CC5ED8215A6E0EFC49B90E9186F0E836FB > /dev/null

Example output:

gpg: keybox '/usr/share/keyrings/qmplay2.gpg' created
gpg: key B90E9186F0E836FB: public key "Launchpad PPA for tomtomtom" imported
gpg: Total number processed: 1
gpg:               imported: 1

With the GPG key now imported, you can import the LaunchPAD PPA that matches your Linux Mint distribution; please ensure these are correct, or else the installation may not work.

Import Linux Mint 21 QMPlay2 PPA

echo "deb [signed-by=/usr/share/keyrings/qmplay2.gpg] jammy main" | sudo tee /etc/apt/sources.list.d/qmplay2.list

Import Linux Mint 20 QMPlay2 PPA

echo "deb [signed-by=/usr/share/keyrings/qmplay2.gpg] focal main" | sudo tee /etc/apt/sources.list.d/qmplay2.list

Before running the installation command, run an apt update to reflect the new imported PPA.

sudo apt update

With the PPA added, you can begin the installation using the following command.

sudo apt install qmplay2 -y

Method 2 – Install QMPlay 2 with Flatpak and Flathub Repository

The second option is to use Flatpak using the Flathub repository. This is natively installed on your desktop by default unless you have removed it previously.

See also
How to Install Apache Cassandra on Rocky Linux EL9 or EL8

Situational – Re-install Flatpak

First, re-install the Flatpak manager if you removed it. For most users, this should not be the case.

sudo apt install flatpak -y

From here, I would reboot your system.

sudo reboot

Run QMPlay2 Installation Commands

For most users, you need to enable Flatpack using the following command in your terminal to start installing applications from the Flathub repository.

sudo flatpak remote-add --if-not-exists flathub

Now install QMPlay2 using the following flatpak command.

flatpak install flathub io.github.zaps166.QMPlay2 -y

Troubleshoot Flatpak QMPlay2 Installation

First, the most common error when installing a Flatpak from Flathub is the following error output.

"error: Unable to load summary from remote flathub: Can't fetch summary from disabled remote 'flathub,"

The fix is simple, run the following command to enable Flathub.

flatpak remote-modify --enable flathub

This will fix the issue the above issue. The next issue can be access to system files. I would only recommend using the following command if you have access permission with your installation accessing files; use the override command below.

sudo flatpak override io.github.zaps166.QMPlay2 --filesystem=host

Please do not use this command by default unless it is needed.

How to Launch QMPlay2

Launching can be done in a few ways now that you have the software installed.

In your terminal, use the following command.


Flatpak installations can use the alternative command instead.

flatpak run io.github.zaps166.QMPlay2

Alternatively, use the suggested path below to open the application using the GUI application menu icon.

Taskbar > Sound & Audio > QMPlay2


Once open, it is pretty much a straightforward media player. Users from VLC or similar will feel quite at ease using QMPlay2.


On first-time launch, I suggest checking out the settings tab, as you can enable features and customize your player quite a bit.


And that is it, and you have successfully installed the latest version of QMPlay2 using the LaunchPAD PPA or Flatpak with Flathub.

Additional Commands & Tips

How to Update QMPlay2

The software should update itself with your system packages for desktop users using the APT package manager. For users who want to check manually, use the following command in your terminal.

sudo apt update && sudo apt upgrade

Lastly, use the following command for any user that installed QMPlay2 using the Flatpak method.

flatpak update

How to Remove QMPlay2

Use the following command entirely for users who no longer wish to have QMPlay2 on their system and want to remove the software.

sudo apt autoremove qmplay2 --purge

The above command is a blanket command that will remove all associated unused dependencies along with QMPlay2 and any saved data created by the software for complete removal.

See also
How to Install Rust on Linux Mint 21 or 20

Lastly, remove the repository but be mindful that if you have installed other applications, do not remove it. If you did it accidentally, re-import it at the tutorial’s start.

sudo rm /etc/apt/sources.list.d/qmplay2.list

For Flatpak installations, use the following command to remove the application.

flatpak uninstall --delete-data io.github.zaps166.QMPlay2

Next, run the following command for any leftover clean-up.

flatpak remove --unused


The tutorial demonstrated two different methods of installing QMPlay2. Overall I believe it is a great music player for Linux Mint with many features and a great alternative media player for those seeking a lightweight option instead of just grabbing VLC Media Player.

Leave a Comment

Share to...