The Abyss Linux PMR is a signed XBPS repository that ships the Abyss builds of the suckless tools for x86_64 and aarch64. It sits next to the official Void Linux repositories. When suckless releases a new dwm or st, or Abyss improves a patch, every Abyss system picks it up with a normal xbps-install -Su. You don't have to reinstall from a new ISO.

https://mrzakaria.github.io/AbyssLinuxPMR/current

Each suckless package conflicts with Void's stock package of the same tool (dwm, st, …), so only one build is installed at a time. abyss-dwm depends on abyss-theme, so the desktop look arrives with the window manager.

Nothing to do. Abyss Linux 27.0 and later ships with:

• /etc/xbps.d/20-abyss-pmr.conf, which adds the repository,
• /var/db/xbps/keys/c6:f0:d1:05:cb:f1:89:83:58:c2:e2:e4:4c:c9:09:9a.plist, which holds the signing key.

Update the whole system, Abyss packages included:

sudo xbps-install -Su

# 1. trust the Abyss signing key
sudo curl -fLo /var/db/xbps/keys/c6:f0:d1:05:cb:f1:89:83:58:c2:e2:e4:4c:c9:09:9a.plist \
  https://mrzakaria.github.io/AbyssLinuxPMR/keys/c6:f0:d1:05:cb:f1:89:83:58:c2:e2:e4:4c:c9:09:9a.plist

# 2. add the repository
echo 'repository=https://mrzakaria.github.io/AbyssLinuxPMR/current' | sudo tee /etc/xbps.d/20-abyss-pmr.conf

# 3. install (replaces Void's dwm/st/dmenu if you had them)
sudo xbps-install -S abyss-dwm abyss-st abyss-dmenu abyss-slock abyss-tabbed abyss-wmname

If you skip step 1, xbps shows the key fingerprint on the first sync and asks whether to import it. It must be:

c6:f0:d1:05:cb:f1:89:83:58:c2:e2:e4:4c:c9:09:9a   (RSA 4096, "Abyss Linux")

The same public key is in keys/abyss-pmr.pub.pem. You can check it yourself: ssh-keygen -l -E md5 -f <(ssh-keygen -i -m PKCS8 -f keys/abyss-pmr.pub.pem).

srcpkgs/abyss-*/template          xbps-src recipe (Void's own format)
srcpkgs/abyss-*/patches/01-*.patch upstream suckless git fixes since the release tarball
srcpkgs/abyss-*/patches/10-*.patch the Abyss changes (patches + config.def.h)
common/build.sh                    clones void-packages, builds x86_64 natively, aarch64 cross
common/sign.sh                     xbps-rindex: index + sign repodata and every package
.github/workflows/build.yml        CI: build -> sign -> publish to GitHub Pages
keys/                              public signing key (plist for xbps, PEM for humans)
etc/xbps.d/20-abyss-pmr.conf       client configuration
site/                              landing page

1. Every package starts from the official release tarball on dl.suckless.org, pinned by its sha256 checksum.
2. xbps-src applies patches/*.patch in order. 01-upstream-git-<rev>.patch brings the tree up to the suckless git revision Abyss tracks. 10-abyss.patch adds the Abyss patches and configuration.
3. GitHub Actions builds in the official ghcr.io/void-linux/void-glibc-full container, the same way Void's own CI does (uchroot masterdir, binary-bootstrap).
4. The repository data and every .xbps are signed with the Abyss RSA key. The private key lives only in the XBPS_SIGNING_KEY Actions secret.
5. The signed repository is published to GitHub Pages at /current.

Everything is reproducible from this repository plus the public tarballs, so anyone can verify that a package matches its recipe.

abyss-dwm (10-abyss.patch)

abyss-st: clipboard (a selection is also copied to CLIPBOARD), the Abyss 16-colour palette, and the font set in points (size=11) so it follows Xft.dpi on HiDPI screens.

abyss-dmenu: center (-c), border (-bw), line-height (-h), password (-P), case-insensitive matching by default, Abyss colours and font.

abyss-theme: /usr/share/themes/Abyss (GTK's Adwaita dark with the Abyss palette), /usr/share/icons/Abyss (inherits Papirus-Dark; 600 folder links point at Papirus' violet set, generated in files/violet-folders.list), and system-wide /etc/xdg/gtk-3.0/settings.ini. A user's own ~/.config/gtk-3.0/settings.ini still wins.

abyss-slock, abyss-tabbed: configuration only (privilege-drop group, colours, font). abyss-wmname: unmodified upstream git.

New suckless release, better patch, new package: see CONTRIBUTING.md. In short:

git clone https://github.com/void-linux/void-packages && cd void-packages
cp -r ../AbyssLinuxPMR/srcpkgs/abyss-* srcpkgs/
./xbps-src binary-bootstrap
./xbps-src pkg abyss-dwm                 # native
./xbps-src -a aarch64 pkg abyss-dwm      # cross

Open a pull request. CI builds both architectures for every PR. Merged changes are signed and published automatically.

Templates, scripts and Abyss patches: MIT (LICENSE). The suckless programs keep their own MIT/X licenses, installed with each package in /usr/share/licenses/.

Part of Abyss Linux.