🐙 [mains-hum] / nix-hypr

My main configuration on hyprland NixOS

---

🐘 Screenshots

---

🐄 Core Stack

Component	Software
WM	Hyprland
Shell	NuShell
Terminal	Foot
IDE	Helix
Bar	Waybar
Launcher	Fuzzel
File Manager	Yazi
Browser	LibreWolf
MP3 Player	Synapse
Wallpaper	swww
Wallpaper Convertor	gowall

---

🐊 Navigation

Keybind	Action	Keybind	Action
Caps Lock + E/Ret	Foot	Caps Lock + Q	Kill
Caps Lock + R	Fuzzel	Caps Lock + F	Fullscreen
Super + Alt + Shift + Q	PowerOff	Caps Lock + W	LibreWolf
Caps Lock + Space	Layout	Alt + Shift + S	Screenshot
Caps Lock + D	Kotatogram	Caps Lock + A	Steam

---

🐋 Installation

Prerequisites

• Fresh NixOS installation
• Username: nixos (recommended)
• Basic understanding of Nix flakes

# Install git
> sudo nano /etc/nixos/configuration.nix

# Add to systemPackages: git
> sudo nixos-rebuild switch

# Clone this repository
> mkdir Pictures
> git clone https://github.com/mains-hum/nix-hypr.git
> cd ~/nix-hypr/nixos

# Copy configuration files
> sudo rm -rf /etc/nixos/configuration.nix
> sudo cp -a home/ img/ modules/ configuration.nix flake.lock flake.nix /etc/nixos

# Rebuild
> sudo nixos-rebuild switch --flake /etc/nixos#nixos

# Reboot your system
> reboot

---

🐧 Important Notes

• Configure your monitor in Hyprland:

> sh /etc/nixos/home/programs/hyprland.nix

monitor = DP-1, 1920x1080@165, 0x0, 1
# For multiple monitors:
# monitor = HDMI-A-1, 1920x1080@60, 1920x0, 1

• Use username nixos for best compatibility
• Do not change the layout switch from ALT + SHIFT (breaks keybindings)
• For multiple monitors, add additional monitor lines
• Convert wallpaper to gtk gtk theme

> gowall convert ~/wallpaper -t custom-ocean

---

🐡 Star this repo if you find it helpful! Made with by mains-hum

---

🐏 License

nix-dotf Copyright (C) 2025-2040 mains-hum

See the LICENSE file for details.