This is my personal NixOS configuration for a clean, keyboard-focused development machine. I built it to keep things simple, consistent, and distraction-free while coding.
demo.mp4
# Run the VM demo
nix run github:knoopx/nix
# Or clone and run locally
git clone https://github.com/knoopx/nix
cd nix
nix run path:.The unattended installer creates a bootable ISO that automatically installs kOS to the first available disk.
# Build the installer ISO
nix build .#installer-iso
# Write it to a USB drive:
caligula burn result/iso/*.iso
# Or test in a VM first
nix run .#installer-vm-test- Minimal clutter: Shell has no widgets and apps take the whole vertical space. Keyboard-driven workflow throughout.
- Unified styling: Consistent colors, fonts, and styles across:
- System GTK/Qt themes and custom Neuwaita icon theme (merged with MoreWaita)
- Terminal emulator (Kitty)
- Text editors (VSCode, Gram, Helix)
- Window manager (Niri with custom color schemes)
- All applications via Stylix theming system
- Reproducible: Everything's declarative, so I can set it up the same way anywhere
- Niri: A modern, Wayland-native tiling window manager that provides efficient keyboard-driven window management with custom layouts and workspaces
- Firefox: Web browser optimized for privacy with uBlock Origin for ad-blocking, custom search engines, and userstyles for consistent theming. Includes policies for enhanced security and performance thanks to BetterFox and GNOME theme integration
- Kitty: GPU-accelerated terminal emulator with theme integration
- Fish: The user-friendly command line shell with custom completions
- Hyprlock: Screen locker with custom theme
- Yazi: Modern terminal file manager
- VSCode: Primary code editor with custom keybindings, themes, and productivity tools
- Helix: Modal text editor inspired by Vim
- nix-ld: Enables the experience (and caveats) of conventional Linux distros into NixOS, avoiding the need to re-package every single binary
- Bat: Cat clone with syntax highlighting
- Btop: Resource monitor
- Delta: Modern diff viewer
- Fzf/Television/Skim: Command-line fuzzy finders
- Nu Shell: Modern shell with structured data processing
- Starship: Customizable prompt
Custom Nu-based scripts for system control:
- Brightness/Display/Volume/Session/Media controls: Keyboard-driven management
- Window/Tablet-mode control: Window management automation
The modules/home-manager/packages/dev/ directory contains language-specific development environments, each providing essential tools for programming in that language:
- Crystal: Compiler, Crystalline language server, Shards package manager, and Mint framework for building web applications
- Go: Compiler, gopls language server, Delve debugger, and build tools for efficient Go development
- JavaScript: Node.js runtime, package managers (Yarn, pnpm), and Bun for modern web development
- Nix: nixpkgs-fmt formatter and development tools for Nix language development
- Nu Shell: Modern shell with plugins for data processing (polars, query, notifications, highlight, skim) and formatting (nufmt)
- Python: Interpreter and development utilities
- Ruby: Interpreter, Bundler for dependency management
- Rust: Compiler and Cargo package manager
- System: C/C++ compilers (GCC, Clang), build tools, and system-level development utilities
- Vicinae: Application launcher inspired by Raycast
- Camper: Home automation control integration
- Vicinae Extensions: Custom extensions for the launcher
- desktop/: Main workstation featuring:
- NVIDIA graphics with CUDA support
- BTRFS filesystem with advanced features
- Container services (Watchtower for updates, SilverBullet)
- Hardware acceleration for AI models
- EasyEffects audio configuration
- Glance dashboard
- minibookx/: Chuwi Minibook X N150 laptop configuration:
- Hardware-specific drivers and optimizations
- Power management and battery optimizations
- vm/: Virtual machine setup for testing with demo scripts
- steamdeck/: Steam Deck configuration with VM test support
- android/: Android Virtual Framework (AVF) image configuration
- live-usb/: Bootable USB configuration for system recovery
- installer/: Unattended installer ISO that automatically partitions and installs kOS:
- Creates 1GB EFI boot partition + XFS root filesystem
- Installs complete system with home-manager configuration
- Auto-reboots after successful installation
- modules/nixos/: System-level configurations including:
- defaults/: Global settings for AI, apps, colors, display, fonts, system, and user
- services/: System services (Plex Media Server, Traefik, Android photo backup, auto-scrcpy, Flatpak, Keyd, etc.)
- system/: Core system settings (boot, documentation, environment, hardware, networking, Nix configuration, packages, programs, users, virtualisation)
- theming/: Stylix theming configuration
- wm/: Window manager and desktop environment settings (Niri, packages, programs, services, XDG)
- modules/home-manager/: User environment configurations:
- packages/: User packages and development tools
- dev/: Language-specific development environments (Crystal, Go, JavaScript, Nix, Nu Shell, Python, Ruby, Rust, System)
- cli.nix: Command-line interface utilities
- gui.nix: Graphical user interface packages
- programs/: Application configurations (VSCode, Firefox, Kitty, Fish, Helix, Hyprlock, etc.)
- firefox/: Firefox with custom policies, profiles, and uBlock rules
- vscode/: VSCode with extensions, keybindings, and user settings
- Other programs: bat, btop, delta, fzf, git, gram, helix, hyprlock, kitty, nix-index, nu-shell, pi-ai, skim, starship, television, vicinae, wezterm, yazi
- wm/: Window manager user settings
- shell.nix: Shell integration with window control
- niri/: Niri window manager configuration
- xdg/: XDG desktop integration, GTK themes, dconf settings
- packages/: User packages and development tools
Package customizations and fixes:
- Theme and UI modifications (Balatro, Glance, Gnome Control Center, Pegasus Frontend, RetroArch, etc.)
- Custom package patches and fixes
Helper functions for creating package derivations:
- theming/: Theme builders (MoreWaita icons, Plymouth themes, Stylix Firefox/Gnome themes)
Utility functions for theming, color manipulation, and module loading:
- theming/: Color conversion utilities (hexToRGB, rgbToHex, etc.)
- listNixModulesRecursive.nix: Custom module loading utility
Custom package definitions:
- Neuwaita Icon Theme
- Control scripts (brightness-control, display-control, editor, file-manager, image-viewer, media-control, session-control, terminal, volume-control, window-control)
- NFO Viewer
- Cromite
- Gram
- Screen recording utilities
- TTS tools
- And other custom packages
- home/: User-specific Home Manager configurations
- flake.nix: Main flake with inputs, outputs, and system configurations
- flake.lock: Dependency lock file for reproducible builds