Vanilla OS First Setup

This utility is meant to be used in Vanilla OS as a first-setup wizard. Its purpose is to help the user to configure the system to their needs, e.g. by configuring snap, flatpak, flathub, etc.

---

Build

Build Dependencies

sudo apt install -y build-essential debhelper \
                    python3 meson \
                    libadwaita-1-dev gettext \
                    desktop-file-utils \
                    libjpeg-dev libnm-dev \
                    libnma-dev libnma-gtk4-dev \
                    ninja-build

Runtime Dependencies

sudo apt install -y python3 python3-gi \
                    python3-tz libadwaita-1-0 \
                    gir1.2-gtk-4.0 gir1.2-adw-1 \
                    gir1.2-vte-3.91 libnm0 \
                    libnma0 libnma-gtk4-0

Optional Dependencies

sudo apt install python-requests # required for conn_check
sudo apt install gir1.2-gweather-4.0 # required for timezones
sudo apt install gir1.2-gnomedesktop-4.0 # required for languages, keyboard
sudo apt install gir1.2-nma4-1.0 # required for network
sudo apt install gir1.2-nm-1.0 # required for network

Build

meson build
ninja -C build

Install

sudo ninja -C build install

Run

vanilla-first-setup

Using custom recipes

Place a new recipe in /etc/vanilla-first-setup/recipe.json or launch the utility with the VANILLA_CUSTOM_RECIPE environment variable set to the path of the recipe.