Installation

This page will guide you throught the installation of MellowPlayer on the supported operating systems.

GNU/Linux

We provide several ways to install a pre-compiled version of MellowPlayer on GNU/Linux:

  1. Native package (only for Ubuntu, Fedora, ArchLinux & openSUSE)
  2. Flatpak
  3. AppImage

To choose which kind of installer you should use, follow those simple rules:

  • Always prefer the native package to any other format if that is available for your distribution. Native package will always integrate better with your desktop and, in most cases, it will pick up proprietary codecs (ffmpeg) from your system if installed.
  • Prefer flatpak over AppImage, especially if the service you want to use require proprietary audio codecs.
  • Use the AppImage if flatpak is not available on your distribution (very unlikely) and you don’t need proprietary codecs.

Fedora

Starting from Fedora 27, MellowPlayer is available from the official stable repositories:

sudo dnf install mellowplayer

Proprietary codecs

Most services require proprietary audio codecs to work. You can install them from the RPMFusion repositories:

sudo dnf install qt5-qtwebengine-freeworld

Flash

Services such as Deezer and Tidal require flash to work. You can install it from the adobe repositories:

sudo rpm -ivh http://linuxdownload.adobe.com/adobe-release/adobe-release-i386-1.0-1.noarch.rpm
sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-adobe-linux
sudo dnf install flash-player-ppapi

Widevine

Some services such as Spotify and Amazon Music requires the widevine ppapi plugin to work, you can install it by running the below commands:

wget https://archive.archlinux.org/packages/c/chromium/chromium-61.0.3163.100-1-x86_64.pkg.tar.xz
wget https://dl.google.com/widevine-cdm/1.4.8.1008-linux-x64.zip
tar -xvf chromium-61.0.3163.100-1-x86_64.pkg.tar.xz
unzip 1.4.8.1008-linux-x64.zip

sudo mkdir /usr/lib/chromium
sudo cp libwidevinecdm.so /usr/lib/chromium
sudo cp ./usr/lib/chromium/libwidevinecdmadapter.so /usr/lib/chromium
sudo chmod 644 /usr/lib/chromium/libwidevinecdm.so
sudo chmod 644 /usr/lib/chromium/libwidevinecdmadapter.so

Note

You might need to adapt this script to download a version of chromium and widevine that match the version used by your Qt installation.

Ubuntu 18.04

Before installing MellowPlayer, make sure the universe repository is enabled:

sudo add-apt-repository universe

Install procedure:

sudo sh -c "echo 'deb http://download.opensuse.org/repositories/home:/ColinDuquesnoy/xUbuntu_18.04/ /' > /etc/apt/sources.list.d/mellowplayer.list"
wget -nv https://download.opensuse.org/repositories/home:ColinDuquesnoy/xUbuntu_18.04/Release.key -O Release.key
sudo apt-key add - < Release.key
sudo apt update
sudo apt install mellowplayer

Ubuntu 18.10

Before installing MellowPlayer, make sure the universe repository is enabled:

sudo add-apt-repository universe

Install procedure:

sudo sh -c "echo 'deb http://download.opensuse.org/repositories/home:/ColinDuquesnoy/xUbuntu_18.10/ /' > /etc/apt/sources.list.d/mellowplayer.list"
wget -nv https://download.opensuse.org/repositories/home:ColinDuquesnoy/xUbuntu_18.10/Release.key -O Release.key
sudo apt-key add - < Release.key
sudo apt update
sudo apt install mellowplayer

ArchLinux

MellowPlayer is available from the AUR, install it with your favorite AUR tool (e.g. yaourt).

yaourt -S mellowplayer

openSUSE Leap 15

Use the openSUSE build service web interface or install manually:

zypper addrepo https://download.opensuse.org/repositories/home:ColinDuquesnoy/openSUSE_Leap_15.0/home:ColinDuquesnoy.repo
zypper refresh
zypper install MellowPlayer

openSUSE Tumbleweed

Use the openSUSE build service web interface or install manually:

zypper addrepo http://download.opensuse.org/repositories/home:ColinDuquesnoy/openSUSE_Tumbleweed/home:ColinDuquesnoy.repo
zypper refresh
zypper install MellowPlayer

KaOS

MellowPlayer is available from KaOSx/apps repository, just run:

$ sudo pacman -S mellowplayer

Flatpak

MellowPlayer’s flatpak is not yet available on flathub but you can download and install a single file bundle:

  1. Download the flatpak from our bintray repository
  2. Install the flatpak: flatpak install ./MellowPlayer.flatpak
  3. Run the flatpak from your application menu or from command line: flatpak run com.gitlab.ColinDuquesnoy.MellowPlayer

AppImage

  1. Download the AppImage from our bintray repository
  2. Make it executable: chmod +x ./MellowPlayer.AppImage
  3. Run it: ./MellowPlayer.AppImage

Compiling from source

See the README for build instructions.

Windows

Just grab the windows installer from the official website (click on the Windows folder) and follow the instructions.

Please note the Windows Installer we provide is built with a version of QtWebEngine built without proprietary codecs support (for licensing reasons). If your favorite service require proprietary codecs to work, you’ll need to build QtWebEngine with the flag use_proprietary_codecs and build MellowPlayer using that QtWebEngine version.

OS X

OSX is not officially supported anymore. You may try to build and run MellowPlayer from sources.