Flatpak is for 64 bit Linux Clients only. All Flatpak commands accept the optional
--user parameter, making the operation affect the
current user only and not the whole system.
A word of warning first, though: If you are short on hard drive space or hate bloat, Flatpak is not for you. Every Flatpak app requires that you also install a runtime; we use the most lightweight one with about 700 Mb. Runtimes are shared between apps so in a world where Flatpak has taken over, their space usage does not matter that much; you can think of it as a Linux distribution, or rather a family of distributions, that sits on top of your own Linux system. The initially large download is minimally compensated for later by savings in downloads for updates; those use differential compression and will not transfer unchanged data and libraries again. Still, it is a lot of data over the wire and on your system.
Armagetron Advanced can be installed from Flathub using the instruction there, or with
flatpak install https://download.armagetronad.org/flatpak/armagetronad-flathub.flatpakref
The most current Armagetron Advanced builds are in our own small repository, you can add it to your system with
flatpak remote-add --if-not-exists armaflat https://download.armagetronad.org/flatpak/armaflat.flatpakrepo
You can browse the repository in the usual way (
flatpak remote-ls armaflat on the command line)
and install the builds from the repository:
# releases flatpak install armaflat org.armagetronad.ArmagetronAdvanced//stable # release candidates flatpak install armaflat org.armagetronad.ArmagetronAdvanced//rc # betas flatpak install armaflat org.armagetronad.ArmagetronBeta # alphas flatpak install armaflat org.armagetronad.ArmagetronAlpha # experimentals flatpak install armaflat org.armagetronad.ArmagetronExperimental
There are more branches for
org.armagetronad.ArmagetronAdvanced; if you are not interested in having
multiple branches installed without older versions overwriting configuration files of newer versions,
you can install the alpha and beta branch for that. If you want a version that will stick to the 0.2.9 series forever, install stable_0.2.9.
If you don’t want to add the repository, you can also install them using these direct references (just click; your system may have an app installed that knows what to do with them):
Or over the commandline:
flatpak install https://download.armagetronad.org/flatpak/armagetronad-stable.flatpakref flatpak install https://download.armagetronad.org/flatpak/armagetronad-rc.flatpakref flatpak install https://download.armagetronad.org/flatpak/armagetronad-beta.flatpakref flatpak install https://download.armagetronad.org/flatpak/armagetronad-alpha.flatpakref flatpak install https://download.armagetronad.org/flatpak/armagetronad-experimental.flatpakref
(This will still add the repository, but in a hidden way so it won’t appear in GUI browsers.)
There will be a start menu entry added for you. It is set up so that it can play back debug recordings, you should be able to assign it to be used when you open an .aarec file.
On the command line, a basic run is done with either one of
flatpak run org.armagetronad.ArmagetronAdvanced flatpak run org.armagetronad.ArmagetronBeta flatpak run org.armagetronad.ArmagetronAlpha flatpak run org.armagetronad.ArmagetronExperimental
If you have both the release and release candidates installed, you can either select the one you want with
--branch=stable argument, or permantently set the one to run with
flatpak make-current org.armagetronad.ArmagetronAdvanced <branch name>
You have to be aware of the big specialty of Flatpak: Armagetron runs in a sandbox and cannot see
most of your files. That’s a problem if you want to record or play back debug recordings. The Flatpak
developers thought of that and implemented file forwarding. Give it the
command line argument and everything between @@ and @@ in the command line is made visible. So you can
playback a recording with
flatpak run --file-forwarding org.armagetronad.ArmagetronAdvanced @@ bug.aarec @@
Creating a recording requires you to create a dummy file, or forwarding will not work:
touch bug.aarec; flatpak run --file-forwarding org.armagetronad.ArmagetronAdvanced --record @@ bug.aarec @@
And if you want to use custom data directories, things get really hairy. To help you, we have an external Flatpak that just contains a script for building the correct command line. Install it with
flatpak install https://download.armagetronad.org/flatpak/armagetronad-launcher.flatpakref
Call it with
flatpak run org.armagetronad.ArmagetronLauncher <your arguments>
As an additional argument, you can specify
--branch <branch name>. That selects one
of the non-default branches.
The default configuration data is also not in its usual space, but in the sandboxed areas
~/.var/app/org.armagetronad.Armagetron*/. Use the game’s “About” page for details.
All these packages can coexist; only Release Candidates and Releases share data.
flatpak update updates you to the current versions.
You can get rid of all installed versions with one simple command:
flatpak uninstall org.armagetronad.
and remove the repository with
flatpak remote-delete armaflat