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
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
ArchLinux¶
MellowPlayer is available from the AUR, install it with your favorite AUR tool (e.g. yaourt).
yaourt -S mellowplayer
Other distributions¶
Pre-compiled packages for other distributions (Ubuntu, openSUSE,…) can be found on our OBS Download Page
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
Widevine Support¶
Some services such as Spotify and Amazon Music requires the widevine ppapi plugin to work, you can install it by running the below script (Tested on Ubuntu 20.04):
#!/bin/bash
#script to download and extract widevine compements, tested on unbutu 20.04
#Uninstall the files
if [ "$1" == "uninstall" ]; then
echo "Uninstalling libwidevinecdm.so"
sudo rm /usr/lib/chromium/libwidevinecdm.so
exit
fi
#Create temp directory
tmp_dir=$(mktemp -d)
echo $tmp_dir
cd $tmp_dir
#set urls and checksums
url1="https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb"
file1=$(basename "$url1")
sha256_1=("229b35f0d41bbb6edd98ce4ab8305994a0f5cd1ac4d9817571f07365b2d1ad80")
#Download Files
wget $url1 -P $tmp_dir
#extract the files
ar -vx $tmp_dir/$file1
tar -xvf $tmp_dir/data.tar.xz --strip-components 4 ./opt/google/chrome/WidevineCdm/_platform_specific/linux_x64/libwidevinecdm.so
#install the files
echo "Installing libwidevinecdm.so to /usr/lib/chromium"
sudo mkdir -p /usr/lib/chromium
sudo install -Dm644 $tmp_dir/WidevineCdm/_platform_specific/linux_x64/libwidevinecdm.so -t /usr/lib/chromium
Widevine support in flatpak¶
Flatpak won’t pick up the system widevine plugin. It must be moved to a place that can be accessed from flatpak (e.g. ~/.var/app/com.gitlab.ColinDuquesnoy.MellowPlayer/
) and
you must instruct QtWebEngine where to find the plugin (using a flatpak override):
mkdir -p ~/.var/app/com.gitlab.ColinDuquesnoy.MellowPlayer/plugins/ppapi
cp /usr/lib/chromium/libwidevinecdm.so ~/.var/app/com.gitlab.ColinDuquesnoy.MellowPlayer/plugins/ppapi/
sudo flatpak override --env=QTWEBENGINE_CHROMIUM_FLAGS="--widevine-path=$HOME/.var/app/com.gitlab.ColinDuquesnoy.MellowPlayer/plugins/ppapi/libwidevinecdm.so --no-sandbox" com.gitlab.ColinDuquesnoy.MellowPlayer
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.