Niri Minimal Dotfiles 🌿

A highly configured, minimal, and aesthetic collection of dotfiles for the Niri scrollable tiling window manager.

This setup focuses on a clean "Noctalia" dark theme, modular configuration, and a keyboard-centric workflow. Everything is designed to work together seamlessly with a consistent color palette and typography.

📸 Gallery

If you are just browsing, here is what this setup looks like.

Desktop & Waybar	Window Overview
Clean desk with modular Waybar	Niri's scrollable window overview
Wallpaper picker	Lazy Vim
:---:	:---:
Fuzzel wallpaper picker	Lazygit terminal UI

OBS Studio	Btop System Monitor
OBS Studio with Normal theme	Btop with Glassy Frost theme

Terminal (Alacritty)	File Manager (Ranger)
Alacritty + Fish + Starship	Ranger console file manager

Audio Visualizer	Obsidian Notes
Custom Cava visualizer	Knowledge base & notes

Game Dev (Godot)	Communication (Discord)
Godot Engine themed	Discord client

Main Landing Page
Main landing page with custom wallpaper

---

🧩 Components

Detailed list of all applications and tools configured in this repository.

Category	Application	Config Path	Description
Window Manager	Niri	niri/	Infinite scrolling tiling WM for Wayland.
Status Bar	Waybar	waybar/	Highly customizable modular status bar.
Terminal	Alacritty	alacritty/	GPU-accelerated terminal emulator.
Shell	Fish	fish/	User-friendly command line shell.
Prompt	Starship	prompt/	Cross-shell customizable prompt.
Editor	Neovim	nvim/	Powered by NvChad v2.5.
Launcher	Fuzzel	fuzzel/	Wayland-native application launcher.
System Monitor	Btop	btop/	Resource monitor (Glassy Frost / Material You themes).
File Manager	Yazi	yazi/	Blazing fast terminal file manager (Rust).
	Ranger	ranger/	VIM-inspired file manager.
	Nautilus	nautilus/	GUI file manager integration.
Notifications	Mako	mako/	Lightweight notification daemon.
Lock Screen	Swaylock	swaylock/	Screen locker for Wayland.
Logout Menu	Wlogout	wlogout/	Wayland based logout menu.
Media Player	MPV	mpv/	Video player with modernz script.
Visualizer	Cava	cava/	Console-based audio visualizer with shaders.
Screenshot	Swappy	swappy/	Wayland native snapshot editing tool.
Git Client	Lazygit	lazygit/	Simple terminal UI for git commands.
Notes	Obsidian	obsidian/	Knowledge base configuration.
Multiplexer	Tmux	tmux/	Terminal multiplexer.
Productivity	Pomoru	pomoru/	Pomodoro timer.

---

⌨️ Keybindings

Essential keybindings for navigating the Niri environment. See niri/keybinds.kdl for the full list.

Key Combination	Action
Mod + Return	Open Terminal (Alacritty)
Mod + Space	Open App Launcher (Fuzzel)
Mod + C	Open VS Code (Code)
Mod + B	Open Browser (Brave)
Mod + E	Open File Manager (Nautilus)
Mod + T	Power Menu (Wlogout)
Super + Alt + L	Lock Screen (Swaylock)
Mod + Shift + /	Show Hotkey Overlay
XF86AudioRaiseVolume	Volume Up
XF86AudioLowerVolume	Volume Down
XF86AudioPlay	Play/Pause Media

---

🛠️ Installation

1. Requirements

Ensure you have the required packages installed. On Arch Linux:

sudo pacman -S niri waybar alacritty fish starship neovim btop yazi ranger fuzzel mako swaylock wlogout mpv cava swappy tmux lazygit

2. Clone Repository

Clone this repository to your minimal dotfiles folder (or directly to .config if you prefer manual management, though using stow is recommended).

git clone https://github.com/youngcoder45/new-niri-minimal.git
cd new-niri-minimal

3. Deploy Configs

Copy the folders to your ~/.config/ directory.

cp -r niri waybar alacritty fish btop fuzzel mako swaylock wlogout ~/.config/
# Add others as needed

Note: For the scripts and custom themes to work correctly, ensure you have the prompt folder configured and fonts installed (Nerd Fonts recommended).

---

⚙️ Features

• Modular Waybar: waybar/modules/ splits configuration for easier editing.
• Custom ZSH-like Fish: Experience the power of Fish with a setup that feels like a turbocharged ZSH.
• NvChad Integrated: Drop-in replacement for standard Nvim config.
• Unified Theming: Noctalia theme consistency across terminal, window manager, and UI apps.
• Hardware Acceleration: Configured for optimal performance on supported GPUs.

---

🔮 Future Plans

• Add Dark / Light mode toggle script
• Improve swaylock visual effects
• Create an automated installation script (install.sh)
• Add more color schemes (Nord, Catppuccin, Gruvbox)
• Integrate rofi as an alternative launcher

---

🤝 Contributing

Contributions are welcome! If you have any improvements, bug fixes, or new feature ideas, please feel free to contribute.

1. Fork the repository.
2. Clone your fork locally.
3. Create a new branch for your feature or fix.
4. Commit your changes with clear messages.
5. Push to your fork and submit a Pull Request.

Please ensure your code follows the existing style and conventions.

---

⭐ Star History

If you find this repository useful, please consider giving it a star!

---

Credits

• Wallpaper: "Rogue" (Located in niri/autostart.sh)
• Theme: Noctalia / Dank Theme / Glassy Frost