Fix dark theme, animation speed, kitty opacity; add README
- libadwaita apps (nautilus, gnome-text-editor) rendered light because gsettings-desktop-schemas + dconf were missing, so the color-scheme prefer-dark autostart silently no-op'd. Add both packages. - Replace Hyprland's slow default animations with the reference laptop's bezier curves + per-leaf speeds (hl.curve + hl.animation). - kitty background_opacity 0.88 -> 0.6 to match the laptop; drop the macOS-only background_blur line (Hyprland supplies the blur). - Add README.md documenting the actual image, build, and test flow.
This commit is contained in:
Breadway
parent
17e3e13e80
commit
569ba01550
4 changed files with 166 additions and 2 deletions
129
README.md
Normal file
129
README.md
Normal file
|
|
@ -0,0 +1,129 @@
|
|||
# BOS — Bread Operating System
|
||||
|
||||
An Arch-based, Hyprland desktop distribution that ships the [bread
|
||||
ecosystem](https://github.com/Breadway) preconfigured. One Calamares install
|
||||
produces a themed, bootable Wayland desktop — no manual Arch bootstrap, no
|
||||
wiring up dotfiles, no per-tool bakery installs.
|
||||
|
||||
> Design rationale and the btrfs/A-B roadmap live in [DESIGN.md](DESIGN.md).
|
||||
> This file is the practical overview: what's in the image, how to build it,
|
||||
> and how to test it.
|
||||
|
||||
## What you get
|
||||
|
||||
- **Compositor**: Hyprland with a native-Lua config (`hyprland.lua`), curated
|
||||
keybinds, snappy animations, blur, and pywal-driven colours on a black base.
|
||||
- **bread ecosystem**, baked into `/etc/skel` from bakery-managed binaries
|
||||
(no network needed at install time): `bread`/`breadd`, `breadbar` (status bar
|
||||
+ notification daemon), `breadbox` (launcher), `breadcrumbs` (Wi-Fi profiles),
|
||||
`breadpad` (notes/reminders), `breadman`, and the `bakery` package manager.
|
||||
- **bos-settings**: a GTK4 control panel that configures every bread\* app's
|
||||
config from a GUI (non-destructively), plus snapshot rollback and bakery
|
||||
updates. See below.
|
||||
- **Login**: greetd + tuigreet → Hyprland session.
|
||||
- **Boot splash**: Plymouth `bos` theme (logo + spinner, black background).
|
||||
- **Theming**: global dark across GTK3 (Adwaita-dark), GTK4/libadwaita
|
||||
(`color-scheme: prefer-dark`), and Qt (qt5ct/qt6ct Fusion dark); Papirus-Dark
|
||||
icons; Bibata cursor.
|
||||
- **Apps**: kitty, nautilus (+ gvfs), Zen browser, VLC, loupe, gnome-text-editor,
|
||||
gnome-calculator, file-roller, with file associations wired in `mimeapps.list`.
|
||||
- **Hardware**: pipewire audio, NetworkManager, BlueZ + blueman, CUPS printing
|
||||
with avahi mDNS discovery, TLP power management, fwupd firmware updates.
|
||||
- **Resilience**: btrfs + snapper + snap-pac + grub-btrfs snapshots on every
|
||||
pacman transaction; zram swap; ufw firewall (deny-incoming, mDNS allowed).
|
||||
|
||||
## Repo layout
|
||||
|
||||
```
|
||||
bos/
|
||||
├── Cargo.toml # workspace (members: bos-settings)
|
||||
├── bos-settings/ # GTK4 unified settings app (Rust)
|
||||
│ └── src/
|
||||
│ ├── config/mod.rs # non-destructive toml_edit config layer
|
||||
│ └── ui/{widgets,window,sidebar}.rs, ui/views/*.rs
|
||||
├── iso/ # archiso profile
|
||||
│ ├── profiledef.sh
|
||||
│ ├── packages.x86_64 # live + installed package set
|
||||
│ └── airootfs/ # files overlaid onto the image
|
||||
│ └── etc/
|
||||
│ ├── skel/ # default user dotfiles (hypr, kitty, gtk, …)
|
||||
│ └── calamares/ # installer config + post-install.sh
|
||||
├── packaging/ # in-house PKGBUILDs for AUR-only deps
|
||||
│ ├── arch/ # bos-settings
|
||||
│ ├── calamares/
|
||||
│ └── bibata/
|
||||
├── .forgejo/workflows/ # CI: build + publish packages to [breadway]
|
||||
├── build-local.sh # native ISO build for this machine
|
||||
└── DESIGN.md
|
||||
```
|
||||
|
||||
## Building the ISO
|
||||
|
||||
`build-local.sh` builds the image natively (no container) and bakes this
|
||||
machine's bakery-installed bread binaries into `/etc/skel`:
|
||||
|
||||
```sh
|
||||
sudo ./build-local.sh # release-quality (xz squashfs)
|
||||
sudo FAST_BUILD=1 ./build-local.sh # fast dev iteration (zstd squashfs)
|
||||
```
|
||||
|
||||
The ISO lands in `out/bos-<date>-x86_64.iso`. The script pins
|
||||
`SOURCE_DATE_EPOCH` (reproducible UUIDs) and rewrites the `[breadway]` repo URL
|
||||
to the Tailscale-reachable Forgejo registry for the build.
|
||||
|
||||
### Why some packages are in-house
|
||||
|
||||
`calamares`, `zen-browser-bin`, and `bibata-cursor-theme` are AUR-only. BOS
|
||||
keeps a PKGBUILD for each under `packaging/` and republishes the built package
|
||||
to the `[breadway]` repo via a Forgejo Actions workflow (built on the hestia
|
||||
self-hosted runner, published with a scoped registry token). `bos-settings`
|
||||
itself publishes the same way on a `v*` tag.
|
||||
|
||||
## Testing in a VM
|
||||
|
||||
A reusable, GPU-accelerated launcher lives at `~/bos-vm/run.sh`:
|
||||
|
||||
```sh
|
||||
~/bos-vm/run.sh install # boot the ISO installer (target disk attached)
|
||||
~/bos-vm/run.sh # boot the installed system from the disk
|
||||
```
|
||||
|
||||
It uses KVM + `-cpu host`, 8 GiB / 8 vCPU, and `virtio-vga-gl` with
|
||||
`-display gtk,gl=on` (virgl) — 3D acceleration is essential for a smooth
|
||||
Hyprland session in QEMU. The disk lives on NVMe (not the tmpfs `/tmp`) to
|
||||
avoid memory pressure.
|
||||
|
||||
## bos-settings
|
||||
|
||||
`bos-settings` edits each bread\* app's TOML **non-destructively**: it parses
|
||||
the file with `toml_edit`, changes only the keys a view exposes, and writes it
|
||||
back — preserving comments and any keys the UI doesn't model (calendar
|
||||
passwords, saved-network passwords, model paths). Views:
|
||||
|
||||
| View | Config |
|
||||
|------|--------|
|
||||
| bread | `bread/breadd.toml` — daemon, lua, modules, all adapters, events, notifications |
|
||||
| breadbar | `breadbar/style.css` override |
|
||||
| breadbox | `breadbox/config.toml` — launcher contexts |
|
||||
| breadcrumbs | `breadcrumbs/breadcrumbs.toml` — settings, saved networks, profiles |
|
||||
| breadpad | `breadpad/breadpad.toml` — settings, model + ollama, reminders, calendar |
|
||||
| Snapshots | `snapper` list / rollback / delete |
|
||||
| Packages | `bakery` installed list + updates |
|
||||
| Hyprland | open config in editor + monitor list |
|
||||
|
||||
Build standalone:
|
||||
|
||||
```sh
|
||||
cargo build --release -p bos-settings
|
||||
cargo test -p bos-settings # includes config round-trip tests
|
||||
```
|
||||
|
||||
## Boot architecture notes
|
||||
|
||||
archiso keeps the kernel and initramfs outside the squashfs, so the installer
|
||||
stages them explicitly: a `shellprocess@kernel` step copies the kernel + ucode
|
||||
into the target `/boot` and writes a stock mkinitcpio preset before the native
|
||||
`initcpio` module builds the initramfs. GRUB is **not** installed by Calamares'
|
||||
`bootloader`/`grubcfg` modules (they leave the ESP empty in this layout) —
|
||||
`post-install.sh` runs `grub-install` (NVRAM **and** `--removable`) +
|
||||
`grub-mkconfig` instead, which is the sequence verified to boot.
|
||||
|
|
@ -57,6 +57,34 @@ hl.config({
|
|||
},
|
||||
})
|
||||
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- Animations — snappy curves + per-leaf speeds (matches the reference laptop;
|
||||
-- the hl.config default above is much slower).
|
||||
-- ---------------------------------------------------------------------------
|
||||
local curves = {
|
||||
easeOutQuint = { type = "bezier", points = { { 0.23, 1 }, { 0.32, 1 } } },
|
||||
easeInOutCubic = { type = "bezier", points = { { 0.65, 0.05 }, { 0.36, 1 } } },
|
||||
almostLinear = { type = "bezier", points = { { 0.5, 0.5 }, { 0.75, 1 } } },
|
||||
quick = { type = "bezier", points = { { 0.15, 0 }, { 0.1, 1 } } },
|
||||
}
|
||||
for name, curve in pairs(curves) do
|
||||
hl.curve(name, curve)
|
||||
end
|
||||
|
||||
local animations = {
|
||||
{ leaf = "global", enabled = true, speed = 10, bezier = "default" },
|
||||
{ leaf = "border", enabled = true, speed = 5.39, bezier = "easeOutQuint" },
|
||||
{ leaf = "windows", enabled = true, speed = 4.79, bezier = "easeOutQuint" },
|
||||
{ leaf = "windowsIn", enabled = true, speed = 4.1, bezier = "easeOutQuint", style = "popin 87%" },
|
||||
{ leaf = "windowsOut", enabled = true, speed = 1.49, bezier = "linear", style = "popin 87%" },
|
||||
{ leaf = "fade", enabled = true, speed = 3.03, bezier = "quick" },
|
||||
{ leaf = "layers", enabled = true, speed = 3.81, bezier = "easeOutQuint" },
|
||||
{ leaf = "workspaces", enabled = true, speed = 1.94, bezier = "almostLinear", style = "fade" },
|
||||
}
|
||||
for _, animation in ipairs(animations) do
|
||||
hl.animation(animation)
|
||||
end
|
||||
|
||||
-- ---------------------------------------------------------------------------
|
||||
-- Environment (vendor-neutral; no GPU-specific vars so it works on Intel/AMD).
|
||||
-- ---------------------------------------------------------------------------
|
||||
|
|
|
|||
|
|
@ -1,8 +1,9 @@
|
|||
# BOS kitty config.
|
||||
# Translucent background so Hyprland's blur shows through behind the terminal,
|
||||
# while text stays fully opaque. Colours are left to kitty's default / pywal.
|
||||
background_opacity 0.88
|
||||
background_blur 1
|
||||
# 0.6 matches the reference laptop; the actual blur is supplied by Hyprland's
|
||||
# decoration:blur (kitty's own background_blur is macOS-only).
|
||||
background_opacity 0.6
|
||||
|
||||
font_family JetBrains Mono
|
||||
font_size 11.0
|
||||
|
|
|
|||
|
|
@ -95,6 +95,12 @@ libpulse
|
|||
# GTK3 dark theme (Adwaita-dark); without this package the gtk-theme-name in
|
||||
# skel settings.ini silently falls back to the light theme for GTK3 apps.
|
||||
gnome-themes-extra
|
||||
# Schema + backend behind `gsettings set org.gnome.desktop.interface
|
||||
# color-scheme prefer-dark` (set in hyprland.lua autostart). Without these the
|
||||
# gsettings call fails silently and libadwaita apps (nautilus, gnome-text-editor)
|
||||
# render in LIGHT mode regardless of the GTK theme.
|
||||
gsettings-desktop-schemas
|
||||
dconf
|
||||
# Credential/keyring storage — browsers, SSH agents, and most apps persist
|
||||
# passwords here; without it every session loses saved logins. seahorse is the
|
||||
# GUI to view/manage the stored secrets and keys.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue