dasandClaude Opus 5.5
ecced4e3f4
- Package Calamares 3.4.3 (Qt6, widgets UI) with xbps-src. - das-installer: Calamares setup for Void/runit with Das OS branding and slides. It copies the clean live image (live-base), builds locales and the host-only initramfs, rewrites kernels without sparse tails (GRUB 2.12 cannot read Btrfs holes at the end of a file), then removes itself. - das-snapshots: flat Btrfs layout (@, @home, @snapshots, @var_log, @var_cache_xbps), snapper with hourly snapshots via cronie, grub-btrfs menu, snapper-rollback, and a dracut module that boots read-only snapshots with a RAM overlay. - das-settings 0.2.0: start LightDM with the system locale. - Live image: GRUB, efibootmgr and the new packages; Das OS /etc/issue. - Build: wipe stale destdirs before building packages. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
134 lines
10 KiB
Markdown
134 lines
10 KiB
Markdown
## Das OS
|
||
### _A light, friendly Void Linux–based desktop with Xfce and a Ukrainian touch_
|
||
|
||
[](https://voidlinux.org) [](https://xfce.org) [](https://docs.voidlinux.org/config/services/) [](https://go.dev) [](#)
|
||
|
||
🇺🇦 [Українська версія](README_ua.md)
|
||
|
||
### 💡 Purpose
|
||
Void Linux is fast, simple and independent: runit instead of systemd, and its own xbps package manager. Out of the box, though, it is a bare system, and getting it ready for daily use takes hours of setup. Das OS builds a live ISO that boots straight into a configured Xfce desktop and installs it with a graphical installer. It has its own look, a Ukrainian interface and keyboard layout, the usual desktop apps and Btrfs snapshots that let a broken update be undone. Everything Das OS adds comes from its own xbps packages, so the setup can be reproduced and updated like any other package.
|
||
|
||
### 📃 Features
|
||
- [Live ISO](#LiveISO) that boots on UEFI and BIOS straight into the desktop
|
||
- [Graphical installer](#Installer) (Calamares) set up for Void and runit
|
||
- [Snapshots and rollback](#Snapshots): hourly Btrfs snapshots, bootable from the GRUB menu
|
||
- [Das OS look](#Look): light and dark themes, generated window frames, wallpapers and logo
|
||
- [Desktop defaults](#Defaults) for Xfce that don't overwrite stock files
|
||
- [Own package repository](#Repository) built by xbps-src from in-tree templates
|
||
- [Containerised build](#Build) that runs on any Linux host with Docker, and QEMU scripts for testing
|
||
|
||
### ⭐ Advantages
|
||
- **Void underneath** – a fast runit boot, the xbps package manager and fresh software, with none of the manual setup.
|
||
- **Safe updates** – the system can return to any snapshot, and personal files in `/home` are never part of a rollback.
|
||
- **Light** – no systemd, plus Xfce, LightDM and PipeWire, so it runs well on older laptops too.
|
||
- **Nothing hidden** – all customisations ship as ordinary xbps packages, so `xbps-query -f das-settings` shows exactly what changed.
|
||
- **Users keep control** – defaults live in `/etc/xdg/das`, so a user's own settings always take precedence and upgrades never reset them.
|
||
- **Builds anywhere** – the build runs in a Void container, so the host can be Mint, Ubuntu or Fedora.
|
||
|
||
### 📱 Screenshots
|
||
<table>
|
||
<tr>
|
||
<td align="center"><img src="images/desktop.png" width="300" alt="Live desktop" /></td>
|
||
<td align="center"><img src="images/desktop-terminal.png" width="300" alt="Terminal and window frames" /></td>
|
||
<td align="center"><img src="images/boot-menu.png" width="300" alt="Boot menu (UEFI)" /></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><i>Live desktop</i></td>
|
||
<td align="center"><i>Terminal and window frames</i></td>
|
||
<td align="center"><i>Boot menu (UEFI)</i></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><img src="images/wallpaper-light.png" width="300" alt="Light wallpaper" /></td>
|
||
<td align="center"><img src="images/wallpaper-dark.png" width="300" alt="Dark wallpaper" /></td>
|
||
<td align="center"><img src="images/window-frames.png" width="300" alt="Window frames" /></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><i>Light wallpaper</i></td>
|
||
<td align="center"><i>Dark wallpaper</i></td>
|
||
<td align="center"><i>Window frames: light and dark, active and inactive</i></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><img src="images/installer-welcome.png" width="300" alt="Installer" /></td>
|
||
<td align="center"><img src="images/installer-partitions.png" width="300" alt="Disk setup with Btrfs" /></td>
|
||
<td align="center"><img src="images/grub-snapshots.png" width="300" alt="Snapshots in the boot menu" /></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><i>Installer</i></td>
|
||
<td align="center"><i>Disk setup with Btrfs</i></td>
|
||
<td align="center"><i>Snapshots in the boot menu</i></td>
|
||
</tr>
|
||
</table>
|
||
|
||
### 📌 Using
|
||
|
||
#### Live ISO<a id='LiveISO' />
|
||
**_The live system logs in to the desktop on its own, with no installation needed._**
|
||
- Boots on UEFI (GRUB) and on legacy BIOS (isolinux), both with a Das OS splash screen.
|
||
- The *graphics disabled* entry boots with `nomodeset` for machines whose screen stays black, and the *RAM* entry copies the whole system to memory.
|
||
- User `live`, password `live`, with `sudo` that needs no password. The user is created at boot and exists only in the live session.
|
||
- Ukrainian interface (`uk_UA.UTF-8`) and the Kyiv time zone by default. Keyboard layouts are `us,ua`, switched with Alt+Shift.
|
||
- Includes NetworkManager, Bluetooth, PipeWire sound and Firefox with the Ukrainian language pack. Services run under runit: `dbus`, `elogind`, `polkitd`, `NetworkManager`, `bluetoothd`, `lightdm`.
|
||
- Includes guest tools for QEMU/SPICE and VirtualBox.
|
||
- The *Install Das OS* icon on the desktop and in the menu starts the installer.
|
||
|
||
#### Graphical installer<a id='Installer' />
|
||
**_Calamares installs Das OS in a few steps: language and time zone, keyboard, disk, user._**
|
||
- The interface is in Ukrainian by default, with the Kyiv time zone and Das OS branding and slides.
|
||
- The disk can be erased automatically or partitioned by hand. Btrfs is the default, ext4 and XFS are also available. On UEFI machines it creates a 512 MiB EFI partition.
|
||
- It copies the clean live image (`/dev/mapper/live-base`), without the live user and its boot-time settings.
|
||
- After copying, it builds locales for the chosen language, removes the virtual machine guest tools on real hardware, sets up snapshots, builds the initramfs and installs GRUB.
|
||
- When it finishes, it removes itself and the packages that only it needed.
|
||
- Disk encryption is not offered yet.
|
||
|
||
#### Snapshots and rollback<a id='Snapshots' />
|
||
**_Btrfs snapshots keep the system recoverable after a bad update._**
|
||
- The installer creates the subvolumes `@` (root), `@home`, `@snapshots`, `@var_log` and `@var_cache_xbps`. Root snapshots don't include personal files, logs or the package cache.
|
||
- snapper makes a *Fresh install* snapshot right after installation and an hourly snapshot (cron). It keeps the last 5 hourly, 7 daily and 2 weekly ones.
|
||
- grub-btrfs adds every snapshot to the *Das OS snapshots* submenu in GRUB and updates it as snapshots appear.
|
||
- A snapshot is read-only. When it boots, the `das-snapshot-overlay` dracut module puts a writable overlay in RAM on top, so the full desktop works. Changes made there are lost at shutdown.
|
||
- `sudo snapper-rollback <number>` makes the snapshot the new root (the old one is kept as `@<date>`). The change takes effect after a reboot. It works both from the running system and from a booted snapshot.
|
||
- Members of `wheel` can list snapshots without sudo: `snapper list`.
|
||
|
||
#### Das OS look<a id='Look' />
|
||
**_A modern minimal style with a blue and yellow eight-petal star from Ukrainian embroidery._**
|
||
- The GTK themes `DasOS` and `DasOS-Dark` build on adw-gtk3 and add the Das OS accent colours. They also style the Xfce panel, which adw-gtk3 leaves black.
|
||
- The xfwm4 window frames (rounded corners, round buttons, a red close button on hover) are generated as PNG files by `xfwm4gen` (Go) from a single palette.
|
||
- Light and dark wallpapers show the star over a rushnyk-style embroidered ribbon. The same star is the Das OS logo and the menu button.
|
||
- Fonts are Inter for the interface and JetBrains Mono in the terminal. Icons are Papirus and the cursor theme is Adwaita.
|
||
|
||
#### Desktop defaults<a id='Defaults' />
|
||
**_The das-settings package configures Xfce without touching files owned by other packages._**
|
||
- `/etc/profile.d/das-xdg.sh` puts `/etc/xdg/das` before `/etc/xdg`, and xfconf reads the Das OS defaults from there.
|
||
- One bottom panel holds the Whisker menu, window buttons, tray, keyboard layout, volume, notifications, clock and a show-desktop button.
|
||
- At the first login, `das-session-init` sets the wallpaper on every connected monitor, because Xfce stores wallpapers per monitor name.
|
||
- LightDM uses the GTK greeter with the Das OS theme and wallpaper.
|
||
|
||
#### Own package repository<a id='Repository' />
|
||
**_Every Das OS file is installed and updated by xbps._**
|
||
- `srcpkgs/das-theme` contains the themes, xfwm4 frames, wallpapers and logo.
|
||
- `srcpkgs/das-settings` contains the Xfce, LightDM and session defaults.
|
||
- `srcpkgs/das-snapshots` contains the snapper configuration, `das-snapper-setup` and the dracut module for booting snapshots.
|
||
- `srcpkgs/das-installer` contains the Calamares settings, branding and installation scripts. It exists only on the live ISO.
|
||
- `srcpkgs/calamares`, `srcpkgs/adw-gtk3` and `srcpkgs/font-jetbrains-mono` package upstream releases that Void does not have.
|
||
- `make packages` lays the templates over a shallow clone of void-packages and builds them with `xbps-src` into `out/hostdir/binpkgs`. The ISO build installs them from there.
|
||
|
||
#### Containerised build<a id='Build' />
|
||
**_The whole build runs in a Docker container, so only Docker and QEMU are needed on the host._**
|
||
1. `make packages` builds the local xbps repository.
|
||
2. `make iso` builds the packages and then the ISO with `void-mklive`, using the profile in `live/` (package list, services, root file system overlay).
|
||
3. `make qemu` boots the newest ISO with UEFI. `make qemu-bios` uses legacy BIOS, and `make qemu-disk` also attaches a 20 GB virtual disk to install on.
|
||
|
||
### 🚀 Building the application
|
||
Requirements: Linux with Docker (the user must be in the `docker` group), QEMU and OVMF for testing, and Go 1.22+ for `make test`. About 10 GB of free disk space.
|
||
```shell
|
||
make iso # build packages and the live ISO (the first run downloads ~2 GB)
|
||
make qemu # boot it in QEMU with UEFI
|
||
make test # run Go tests
|
||
make clean # remove build output, keep the download cache
|
||
```
|
||
The ISO appears in `out/iso/dasos-<version>-x86_64.iso`. Write it to a USB stick with `dd` or Ventoy.
|
||
|
||
**Note:** Das OS is an early version (0.2.0). The Go utilities `das-welcome` and `das-update` (an update with a snapshot taken before it), the developer profile and signed repository hosting are planned for upcoming stages. Until the repository is hosted, an installed system gets updates from Void only. Das OS is based on Void Linux but is not affiliated with it.
|
||
|
||
###### _Made by -=:dAs:=-_
|