The guide walks you through installing QMPlay2 on Linux Mint 20 or 21, offering both official repository and PPA options so you can choose the version that fits your needs. After updating apt and optionally adding the PPA, it covers how to install the package, resolve dependency conflicts with commands like sudo apt install -f, and launch the player via a menu entry or qmplay2 & in the terminal. Troubleshooting sections highlight common issues such as no audio output, plugin errors, and crashes, providing fixes ranging from reinstalling pulseaudio‑module‑bluetooth to deleting configuration files. With its concise steps and practical tips, the article aims to get users listening quickly without chasing broken packages or endless dependency loops.

Install QMPlay2 on Linux Mint 20 or 21 – Quick, No‑Fuss Guide

You’ll learn how to get the lightweight audio player QMPlay2 running on your Mint system without chasing broken packages or endless dependency loops.

Installing from the Official Repository (Mint 21)

1. Open a terminal and update your package list

sudo apt update – this pulls the latest metadata so you don’t hit a “package not found” error later.

2. Install QMPlay2 directly

sudo apt install qmplay2 – Mint ships a version that works out of the box, but it may be slightly older than what the developers want.

If you’re on Mint 20 or prefer newer features, skip to the PPA section below.

Installing from the QMPlay2 PPA (Mint 20)

1. Add the official PPA:

sudo add-apt-repository ppa:qmplay2/ppa – this gives you access to the latest releases that aren’t in the base repos.

2. Refresh your package list again:

sudo apt update

3. Install or upgrade QMPlay2:

sudo apt install qmplay2 – now you get the current build with all recent bug fixes.

Dealing with Dependency Hiccups

Sometimes the PPA pulls in a newer libmad or ffmpeg that conflicts with what Mint already has:

• If you see errors about “conflicting packages”, run

sudo apt install -f – this forces APT to resolve missing dependencies automatically.

• For stubborn cases, consider purging older audio libraries:

sudo apt purge libmad0 ffmpeg – be careful; only do this if you know the other apps won’t break.

Launching QMPlay2

You can start it from the menu under “Audio” or via terminal with:

qmplay2 &

The ampersand runs it in the background so your shell stays free for more commands.

If the window doesn’t pop up, double‑check that xorg is running and you’re not in a headless session.

Common Troubleshooting

• No sound after installing – I once hit this after swapping from VLC to QMPlay2; the fix was to reinstall the Pulseaudio module:

sudo apt reinstall pulseaudio-module-bluetooth.

• Plugin errors (e.g., “failed to load decoder”) – run qmplay2 --debug and look for missing libs; install them with APT.

• Crashes on startup – delete the config folder:

rm -r ~/.config/qmplayer2 – it resets all settings, which usually clears the issue.