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:
- Native package (only for Ubuntu, Fedora, ArchLinux & openSUSE)
- Flatpak
- 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
Flatpak¶
MellowPlayer’s flatpak is not yet available on flathub but you can download and install a single file bundle:
- Download the flatpak from our bintray repository
- Install the flatpak:
flatpak install ./MellowPlayer.flatpak
- Run the flatpak from your application menu or from command line:
flatpak run com.gitlab.ColinDuquesnoy.MellowPlayer
AppImage¶
- Download the AppImage from our bintray repository
- Make it executable:
chmod +x ./MellowPlayer.AppImage
- Run it:
./MellowPlayer.AppImage
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.