No description
Find a file
2026-11-15 23:47:14 +10:00
assets tweak: wallpapers and themes 2026-10-03 03:08:44 +10:00
modules add dev drive 2026-11-15 23:47:14 +10:00
vendor Massive refactor 2026-11-15 22:13:38 +10:00
.gitignore yiack 2026-10-11 03:59:00 +10:00
.gitmodules Massive refactor 2026-11-15 22:13:38 +10:00
flake.lock Massive refactor 2026-11-15 22:13:38 +10:00
flake.nix Massive refactor 2026-11-15 22:13:38 +10:00
hardware-configuration.nix yiack 2026-10-11 03:59:00 +10:00
LICENSE Config 2026-10-10 21:27:36 +10:00
README.md Massive refactor 2026-11-15 22:13:38 +10:00

SerenityOS

Declarative NixOS configuration with Flakes & Home Manager
(no it's not the ladybug)

NixOS License


screenshot

💻 System Information

Software In Use

Component Implementation
OS NixOS Unstable
Display Server Wayland
Session Manager Regreet
Window Manager Niri
Desktop Noctalia
Terminal Kitty
Shell Fish
Editor Helix
Browser Firefox
File Manager Yazi
Themeing Stylix
Filesystem Btrfs (root), FAT32 (EFI)

Machine profile: fractal

fractal is the only host configuration maintained in this repository.

The fractal host targets Porta's MSI MS-7C95 desktop (AMD Ryzen 5 5500, NVIDIA GeForce RTX 5060 Ti, Intel Wireless-AC 3168 Wi-Fi/Bluetooth, and x86_64 UEFI). It enables the Niri/Noctalia desktop, terminal tools, gaming, and multimedia modules. The configured displays are HDMI-A-1 at 1920×1080/180 Hz and DP-2 at 1920×1080/60 Hz.

The host configuration does not select or partition a disk. Before installing NixOS, decide which drive and filesystem to use. After mounting the target at /mnt and cloning this repository to /mnt/etc/nixos, run nixos-generate-config --root /mnt --force. This replaces the tracked root-level hardware-configuration.nix placeholder with detected hardware, filesystem, and UUID settings; the fractal-hardware module imports it automatically. This machine currently runs Arch Linux, so the profile has not been installed or switched on the running system.

The account is configured as porta and uses the local Git identity. No login password is stored in the Nix configuration; after mounting the installed system at /mnt, set one before the first normal login with nixos-enter --root /mnt -c 'passwd porta'.

The cream-installer feature installs CreamInstaller using its upstream Nix package, pinned in flake.lock. It is enabled on fractal and applies the upstream WebKit workaround automatically when NVIDIA video drivers are configured. Add cream-installer to another host's module list to enable it there; run creamlinux or use the desktop launcher after rebuilding.

Repository setup and Minecraft Plymouth theme

Clone with git clone --recurse-submodules <repository-url>. For an existing checkout, run git submodule update --init --recursive before evaluating or rebuilding the configuration.

The Minecraft Plymouth theme lives in vendor/minecraft-plymouth-theme as a Git submodule of nikp123/minecraft-plymouth-theme. Its revision is pinned by the parent repository. The flake uses a relative path and includes submodules automatically; this requires Nix 2.27 or newer. nix flake update does not advance this submodule. To update it deliberately, run git submodule update --remote vendor/minecraft-plymouth-theme, then nix flake lock, review the changes, and commit the updated submodule pointer with any lock-file changes.

The Fractal profile imports the theme's module but currently leaves boot.plymouth.plymouth-minecraft-theme.enable disabled. This cleanup preserves that boot behavior.

Themes and maintenance

Feature modules rely on the shared core module for Home Manager integration.

Select a theme by changing the self.nixosModules.theme-tokyo-night import in modules/system/user.nix. The variants in modules/features/themes/ share fonts, cursor, media files, and opacity through theme-common; wallpaper and palette choices remain in each variant.

Run nix fmt to format the configuration and nix eval --raw .#nixosConfigurations.fractal.config.system.build.toplevel.drvPath to check system evaluation before a rebuild.

Common Commands

Command Description
hx <path/to/file> Edit file
nix flake update Update system
git add --all && git commit -m "<message>" Save system changes or updates to git tree
sudo nixos-rebuild test --flake .#<host> Test changes or updates without switching
sudo nixos-rebuild switch --flake .#<host> Apply system changes or updates

📋 To-Do List

📝 Dev Notes

For the purposes of authenticity and earnestness

  • I will not rebase or squash any commits
  • I will not remove any outdated branches

📜 License

  • MIT License: Feel free to use and modify as you wish.

📚 Learning Resources

🙋 Attributions

Artwork

Code


Built with 🩵