Installation

From Source

Dependencies

First install the dependencies.

APT based systems (Debian/Ubuntu/Mint/etc)

sudo apt install git libcairo2-dev gcc python3-dev libgirepository1.0-dev libostree-dev fuse-overlayfs python3-venv libcap-dev autoconf meson ostree

DNF based systems (Fedora/RHEL/CentOS/etc)

sudo dnf install git cairo-devel gcc python3-devel gobject-introspection-devel ostree-devel fuse-overlayfs libcap-devel autoconf cairo-gobject-devel meson ostree

pacman based systems (Arch Linux/Endeavour OS/Manjaro/etc)

sudo pacman -Sy base-devel cairo git gobject-introspection-runtime python3 ostree fuse-overlayfs meson

MaPS

Clone maps to somewhere convenient.

git clone https://github.com/aaruni96/maps.git && cd maps

Setup a python venv, and install the python dependencies.

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Check that MaPS works

./src/maps --list

Using a Package Manager

!!THIS IS CURRENTLY EXPERIMENTAL!!

APT based systems

Note, this requires a distribution which bundles the python-tuspy package, for example, Debian 12 and newer, or Ubuntu 24.04 and newer. Check https://repology.org/project/python%3Atuspy/versions for more details.

1. Download the maps installer in the .deb format from https://github.com/mardI4NFDI/maps/releases/latest .

2. Install this file using the terminal

   sudo apt install ./maps*.deb

Arch based systems

MaPS is published on the Arch User Repository (aur). You can download and install MaPS from the AUR.

Using an AUR helper

Install maps using your aur helper. For example, if you use yay, the command is

yay -S maps

Manually

1. Install tuspy from the aur.

   git clone https://aur.archlinux.org/python-tuspy.git && cd python-tuspy
   makepkg -si

2. Install maps from the aur

   git clone https://aur.archlinux.org/maps.git && cd maps
   makepkg -si

DNF based systems

Make sure COPR is installed

sudo dnf install dnf-plugins-core

Enable the python3-tuspy and maps copr repositores

sudo dnf copr enable aaruni96/python3-tuspy
sudo dnf copr enable aaruni96/maps

Install MaPS using DNF

sudo dnf install maps