# VesperOS Build System

VesperOS is a custom Debian-based OS built using a system based on `pi-gen`.

## Dependencies

The VesperOS Build System relies on `pi-gen` and is compatible with Debian-based operating systems released after 2017. We recommend using the latest OS versions for better security.

For other Linux distributions, you can use the Docker-based build method provided below.

To install the required dependencies for building VesperOS, run the following command:

```bash
apt install coreutils quilt parted qemu-user-static debootstrap zerofree zip \
dosfstools e2fsprogs libarchive-tools libcap2-bin grep rsync xz-utils file git curl bc \
gpg pigz xxd arch-test bmap-tools kmod squashfs-tools xorriso mtools
```

The `depends` file in the repository lists all the necessary tools, formatted as `<tool>[:<debian-package>]`.

## Getting Started with Building VesperOS

To start building VesperOS, clone the os-builder repository:

```bash
git clone https://git.oxmc.me/VesperOS/os-builder.git
```

For a shallow clone containing only the latest revision, you can add `--depth 1`. **However, avoid using this on your development machine**.

Make sure the repository is cloned to a directory **without spaces**, as spaces in the base path may cause `pi-gen` to fail.

Once cloned, you're ready to configure and start building VesperOS.