First and foremost, the reference to the awesome project:

upplay

Not all distros have a Upplay package available. For Arch and derived, there is an AUR package, but the application does not look good at least on my Gnome desktop: borders are missing. Or, you might simply not be comfortable installing an AUR package.

You need to have Docker up and running on a Linux machine, and the current user must be allowed to run containers (this usually means that the current user belongs to the "docker" group). You can verify whether your user belongs to the "docker" group with the following command:

getent group | grep docker

This command will output one line if the current user does belong to the "docker" group, otherwise there will be no output.

The Dockerfile and the incluted scripts have been tested on the following distros:

• Manjaro Linux with Gnome (amd64)

As I test the Dockerfile on more platforms, I will update this list.

You can build (or rebuild) the image by opening a terminal from the root of the repository and issuing the following command:

sh build

It will take a while. When it's finished, run:

docker volume create upplay_config
docker run --rm --user $(id -u):$(id -g) -it -e DISPLAY=:0.0 --net=host --volume=${HOME}/.Xauthority:/config/.Xauthority:ro --volume upplay_config:/root/.config/Upmpd.org upplay

This command should generally work. You might need to tweak the DISPLAY variable value, and of course binding "/root/.config/Upmpd.org" is definitely not mandatory if you don't need to maintain the configuration settings.

You can avoid the dependency with the terminal which started upplay by detaching the process, just add '-d' after 'run' in the previous command.

Alternatively, you can just run the convenience scripts

sh run-upplay-docker

In case of need, you can reset your upplay configuration by typing:

sh reset-prefs

If the application runs properly with the previous command, you might want to be able to launch it by your desktop environment. You can install the menu entry by running the included convenience script. Open a terminal and issue the following:

sh create-desktop-entry

This script will copy the "run-upplay-docker" script to "$HOME/.local/bin/", copy the icon "upplay-docker.png" to "$HOME/.local/share/icons/", then copy the desktop file "upplay-docker.desktop" to "$HOME/.local/share/applications/".

On Gnome, just wait a few seconds and the new application will be available.