OrynOS icon indicating copy to clipboard operation
OrynOS copied to clipboard

A declarative, high-performance NixOS configuration built with Hyprland, TTY login, and modular design. Fast, sovereign, and reproducible.

OrynOS - A Declarative Digital Sanctum

"Within these lines, a digital world takes form,
Crafted with Nix, resilient to any storm."



🌟 Overview

OrynOS Desktop Preview

Welcome, traveler, to the heart of OrynOS – a meticulously sculpted NixOS configuration that transcends mere dotfiles. This repository is the digital loom upon which a personalized, performant, sovereign, and perfectly reproducible computing experience is woven.

What began as a journey through various digital landscapes has culminated in this current form: a swift Hyprland session, launched directly from the bare TTY for uncompromised speed and display fidelity, built upon the robust foundation of the HyDE framework.

🎯 Key Features

Feature Description
🔄 Declarative Every configuration is code – reproducible and version-controlled
📦 Flatpak Manager Declarative flatpak manager for NixOS
⚡ Performance TTY-direct Hyprland for maximum speed and minimal overhead
🔒 Sovereign Privacy-focused, telemetry-free, complete control
🎨 Aesthetic Global Catppuccin Mocha + Custom Helios color palette
🧩 Modular Clean separation of concerns for maintainability
🛡️ Secure Lanzaboote integration for UEFI Secure Boot
🖌️ Themes swww Wallpaper daemon + Theme select + Rofi launcher select
⚙️ System UI Wlogout + hyprlock + hypridle + Game Launcher + Waybar
💻 Terminal & Shell Alacritty + Kitty + Zsh + Starship

📸 Gallery

neovim, fastfetch, cava btop, firefox, cmatrix


🔮 Philosophy: Sovereignty Through Code

Principle Implementation
🔄 Declarative Purity System described, not configured – Nix translates descriptions into immutable reality
♻️ Reproducibility Consistent builds across time and hardware – your environment as version-controlled code
⚡ Performance & Control Direct TTY → Hyprland for raw speed and complete display dominion
🧩 Modularity & Clarity Logical separation in programs/, hosts/, and home/ for maintainable complexity
🔒 Digital Sovereignty Freedom from telemetry, tracking, and opaque processes
🌑 Dark Aesthetic Dark and deep aesthetic theme via Catppuccin & custom Helios palette + Hyde modules

🚀 Technology Stack


🛠️ Quick Start

Prerequisites

  • NixOS with flakes enabled
  • Home Manager (optional for user-only configs)

Installation

# Clone the repository
git clone https://github.com/OrynVail/OrynOS.git
cd OrynOS

# Build and switch the NixOS system configuration
sudo nixos-rebuild switch --flake .#oryn-nixos

# Optional: Build standalone Home Manager configuration
home-manager switch --flake .#oryn@oryn-nixos

Customization

  • Hardware: Modify hosts/oryn-nixos/hardware-configuration.nix
  • Programs: Add/modify application configs in programs/
  • Host Settings: Customize system settings in hosts/oryn-nixos/default.nix

🔧 Maintenance

Cleanup & Optimization

OrynOS includes custom maintenance scripts:

# Interactive system cleanup
./scripts/oryn_cleanup.sh (zsh alias="clean")

# System audit 
./scripts/oryn_audit.sh

Updates

# Update flake inputs
nix flake update

# Rebuild with latest changes
sudo nixos-rebuild switch --flake .#oryn-nixos

📊 Statistics

GitHub repo size Code Size

🤝 Contributing

Contributions are welcome! Ways to Contribute :

  • 🐛 Report bugs or issues
  • 💡 Suggest new features or improvements
  • 📝 Improve documentation

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.


🙏 Acknowledgments

  • NixOS Community - For the incredible ecosystem
  • HyDE - Foundation and inspiration
  • Hyprland - The amazing Wayland compositor

🌟 Support OrynOS

If you find this project useful, consider:

❄️ by Oryn