Looks matter. It is a good thing to have utility with a good rice.
A single-host NixOS + home-manager configuration, wired together with flake-parts instead of one monolithic flake.nix. Every file under modules/ auto-imports itself via lib.fileset — see flake.nix — so adding a new module is just adding a new .nix file, no import list to maintain. Details in docs/architecture.org.
| Util | Program used |
|---|---|
| Shell | Bash · starship · carapace · zoxide · fzf / television |
| Desktop Environment | umbriel (compositor) · Noctalia (bar, dock, launcher, lock screen, greeter) |
| Editor | Emacs (pgtk, daemon + emacsclient) |
| Terminal | foot (via footclient) · kitty module present but disabled |
| Launchers | Noctalia launcher · wlr-which-key menus · xdg-launcher inside Emacs |
| Audio | PipeWire · wiremix · cava |
| System Monitor | bottom · htop · gdu |
Gmail account declared in accounts (credentials via pass); no mail client wired up yet | |
| Chat | Vesktop (Discord) · Emacs ERC / rcirc (IRC, via soju) · Emacs ement.el (Matrix) |
| File Manager | Emacs Dired · PCManFM (GUI fallback) |
| RSS Reader | Newsticker (Emacs) |
| Documents | zathura · emacs-reader · LibreOffice · pandoc · LaTeX / Typst |
| Media | mpv (uosc, SponsorBlock) · EMMS · swayimg |
| Downloads | aria2 (RPC + systemd) · yt-dlp (yt-music, yt-playlist helpers) |
| Theme | Stylix — One Dark (base16), Papirus-Dark icons, phinger cursors, JetBrainsMono Nerd Font |
| Browser | Firefox (hardened) · qutebrowser · w3m |
| Secrets | agenix · pass / GPG |
| Version Control | Git + Jujutsu (GPG-signed) · gh / gh-dash · Magit + majutsu |
| Network | NetworkManager (iwd backend) · impala · bluetui · LocalSend |
| Virtualisation | libvirt / QEMU · virt-manager |
| Agenda / Task Maintainer | Emacs + org-mode |
Fresh machine: follow docs/installation.org. Already installed:
cd ~/etc/nixos
nix flake update
nos # alias for: nh os switch
The repo is expected to live at ~/etc/nixos (see architecture for why).
All longer-form documentation lives in docs/ (index: docs/README.org).
| Page | What it covers |
|---|---|
| installation | Install from an ISO, restore GPG / pass / agenix keys, Nix tokens |
| architecture | Layout, module auto-import, adding a module, adapting to a new user |
| usage | Aliases, helper commands, updating |
| keybindings | Compositor, which-key, Emacs, qutebrowser, zathura |
| theming | How Stylix feeds everything, and what is hand-themed |
| secrets | agenix, pass / GPG, keyring, backups |
| tool-inventory | One row per job; overlapping tools flagged |
| troubleshooting | Known gotchas and fixes |
| new-host | Adding a second machine |
| learning-resources | Nix / NixOS / flakes reading list |
Near the code: why Emacs, literate Emacs config, Firefox userChrome notes, and TODO.org.
Add a few screenshots (desktop, Emacs dashboard, Noctalia bar) under .github/images/ and show them near the top of this file.
Licensed under the GNU General Public License v3.0. See LICENSE for details.