Skip to content

How to download and run the app

You want Armarius on a new computer, or a friend at the table wants to try it. You don't need Python: each Release on the app's GitHub page, under Releases, has a download for Windows and one for Linux.

Each is a zip named like Armarius-X.Y.Z-windows.zip, where X.Y.Z is the version. It holds the whole app, with its books' catalogs, the Tribunal packs and the tutorials. Your sagas are never inside it. They're kept in your save folder, so a newer download finds them.

Windows

  1. Unzip it. Download the Windows zip, right-click it and choose Extract All. Put the folder it makes, Armarius-X.Y.Z, wherever you keep programs, such as your Documents.
  2. Start it. Open the folder and double-click Armarius for the desktop app. armarius-terminal, in the same folder, starts the terminal version.
  3. Let Windows run it. The first time, Windows may say "Windows protected your PC", because the app isn't signed with a paid certificate. Click More info, then Run anyway. It asks only once for each version.
  4. Pin it. Right-click Armarius and choose Pin to Start, or Send to, then Desktop (create shortcut).

Linux

  1. Unzip it. Download the Linux zip and run unzip Armarius-X.Y.Z-linux.zip.
  2. Start it. Run ./Armarius-X.Y.Z/Armarius for the desktop app, or ./Armarius-X.Y.Z/armarius-terminal in a terminal for the terminal version.

It runs on Ubuntu 22.04 and other systems of that age or newer. The desktop app needs the usual desktop libraries. If it won't start, run it from a terminal to see which one is missing.

On GNOME the desktop app draws its windows through X11. If you'd rather use Wayland, start it with QT_QPA_PLATFORM=wayland ./Armarius.

A newer version

The app tells you when a newer version is out: a notice on the title page, with Check now to ask at once and Skip this version to set one aside (see How to check for an App update). Getting it is done by hand, as before:

  1. Unzip the new one. Download the newer zip and unzip it beside the old folder.
  2. Start the new one. Your sagas and settings carry over, since they aren't in the app's folder.
  3. Delete the old folder once the new one works.

An older version still opens a saga the newer one saved, but says so, and can't show what only the newer one knows. If your troupe shares a saga, move to the new version together.

Hosting from a download

Hosting works from a download just as it does from the source (see How to host a saga for your troupe). The first time you host, Windows asks whether to let armarius-terminal through the firewall, as it asks about Python when you run from the source. Allow it on private networks.

Players who join with Remote seats need the same major version of Armarius as you, the first number of the version (the 4 in 4.13.0).

See also: Saga picker, Getting started, How to host a saga for your troupe