Instructions

How to write an .SBUILD

Prerequisite

• Install Soar

  Yes, really. Do it Now: https://soar.qaidvoid.dev/install

• bash, b3sum, curl, coreutils, file, findutils (find, xargs), fuse3 (fusermount3), gettext, grep, jq, sed, shellcheck, wget, yj, yq

• Some of these can be installed with Soar

soar add 'bash/bash#base' \
'b3sum#bin' \
'curl#bin' \
'findutils/find#base' \
'grep/grep#base' \
'jq#bin' \
'sed#bin' \
'shellcheck#bin' \
'findutils/xargs#base' \
'yj#bin' \
'yq#bin' --yes

• But if Possible, Use your Distro's own PKG Manager to avoid breaking stuff

• Read the Spec: https://docs.pkgforge.dev/sbuild/specification

• View some Examples : https://github.com/pkgforge/soarpkgs/tree/main/packages

---

Write

• Copy the Generic Template: https://github.com/pkgforge/soarpkgs/blob/main/templates/generic.SBUILD.yaml

• Use the Repology Fetcher: https://github.com/pkgforge/soarpkgs/blob/main/scripts/repology_fetcher.sh

!#Assuming You have READ & VERIFIED what the script contains
source <(curl -qfsSL "https://raw.githubusercontent.com/pkgforge/soarpkgs/refs/heads/main/scripts/repology_fetcher.sh")
#The function itself is `repology_fetcher` but is aliased to `repology-fetcher` for convenience
#If you don't want to source it, just download and save it somewhere in $PATH

!#Run it with the app/pkg_name
repology-fetcher "pkg_name"
#Example: repology-fetcher "librewolf"

If the project is on GitHub, you can use the sbuild-creator to Automate it all by simply providing some values

!#Assuming You have READ & VERIFIED what the script contains
curl -qfsSL "https://raw.githubusercontent.com/pkgforge/soarpkgs/refs/heads/main/scripts/sbuild_creator.sh" -o "./sbuild-creator"

!#Here, in this example, we say package (.pkg) is 'dunst'
# Source Url (.src_url) is https://github.com/pkgforge-dev/dunst-AppImage
# RepoLogy Project (.repology) is 'dunst' 
"./sbuild-creator" -p "dunst" -s "https://github.com/pkgforge-dev/dunst-AppImage" -r "dunst"

#This will autogenerate (may ask for input for some things), run the sbuild-linter & create dunst.SBUILD.yaml & dunst.SBUILD.yaml.validated
#PLEASE DOUBLE CHECK IF THE AUTOGENERATED CONTENT IS CORRECT

#See all supported options
"./sbuild-creator" --help

• Start Filling in the Generic Template by Consulting an Example or the SPEC

• After you are done, you can validate it using the sbuild-linter: https://github.com/pkgforge/sbuilder

!#Add it using Soar
soar add "sbuild-linter#bin" "shellcheck#bin"
#Or Download manually & Add to Path: https://github.com/pkgforge/sbuilder/releases

!#Run it with /path/to/your/SBUILD
sbuild-linter "./example.SBUILD"
#If it's not successful, fix your errors

!#To get pkgver
sbuild-linter "./example.SBUILD" --pkgver

• If your SBUILD gets validated successfully, Congrats! You can now create a Pull Request or an Issue, Remember to Link/Copy&Paste the .validated version of your SBUILD

---

Build

• To Do