Skip to content
Dijo-404Public

About

A clean, professional, highly functional Wayland setup based on the Niri scrollable-tiling compositor and a minimalist Monochrome theme.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

Hype Niri

A clean, professional, highly functional Wayland setup based on the Niri scrollable-tiling compositor and a minimalist Monochrome theme.

Niri Arch Linux Monochrome Theme


Overview

Personal dotfiles for a minimal Arch Linux setup using the Niri scrollable tiling Wayland compositor. Focused on delivering a premium, smooth, and full-featured desktop experience using native Wayland tools.

Tech Stack

Component Tool / Link
Compositor Niri
Bar Waybar
Terminal Alacritty
Shell Zsh + Powerlevel10k
Text Font JetBrains Mono
Waybar Font Roboto with Material Design Icons
Launcher Wofi
Notifications Mako
Lock Screen Hyprlock
Idle Daemon Hypridle
Memory Protection systemd-oomd
Wallpaper Awww
Editor LazyVim
Recording OBS Studio
Login Manager Ly
Fetch App Fastfetch

Installation

For an interactive installation, clone the repository and run the setup script:

git clone https://github.com/Dijo-404/Hype_Niri.git
cd Hype_Niri
./install.sh

Note

See INSTALL.md for manual setup instructions and post-installation steps.


Updating

To pull the latest config changes and apply them:

cd Hype_Niri
git pull
./install.sh

The installer optionally refreshes Arch mirrors, requires a full system upgrade before installing packages, and backs up existing user configurations before replacing them. It uses pacman for official repository packages and yay for missing AUR packages, retaining installed AUR packages and providers. It checks exact missing AUR package names before installing; a failed lookup stops the package phase. Missing AUR packages require a terminal so you can review provider and conflict choices. Run it as your regular user with sudo access, and install yay first with your preferred method.

To update only packages without re-running the full script:

sudo pacman -Syu
yay -Syu --aur

Power profiles switch automatically: Performance on AC, Balanced on battery at 30% or above, and Power Saver below 30%. Manual selections last until the next charger or threshold change. The controller uses D-Bus events and stops at logout; hardware without Performance support uses Balanced.

Docker starts on demand, idle audio devices suspend after five seconds, and file indexing skips dependency/cache directories. Startup and control scripts use locks and atomic writes to prevent duplicate processes and partial configurations.

Super+Shift+W opens a wallpaper picker with cached image previews. Niri animations use ease-out-quad without overshoot. A new window slides down from its own top edge over 180 ms; closing one (Super+Q) slides it back up into that edge over 180 ms, with no opacity change. Other animated Niri transitions run for 180 ms. Maximizing or restoring a column (Super+F) and other resizes show the new contents at once instead of crossfading. The same timing covers window movement, view scrolling, workspace switching, overview and compositor dialogs. Niri can only fade the screenshot UI and the recent-windows switcher, so those switch instantly. Three-finger swipes scroll horizontally or switch workspaces vertically; four-finger vertical swipes open and close overview. Gesture motion follows your fingers; the 180 ms timing applies to settling after release. App startup and shutdown delays are separate from animation duration. Super+A opens and closes Wofi, and Esc also dismisses it, with the same window animations. Search updates every 10 ms; rows use a 180 ms hover transition and one click activates them. The search chevron uses GTK’s symbolic icon renderer. Hyprlock supports only fades, so locking and unlocking fade for 180 ms on a matching quadratic ease-out curve, and the lock screen shows the wallpaper without blur. The lock taken just before sleep stays instant. The power menu (Super+Shift+Delete) is a Wofi list, so Niri animates it like the other menus. Wallpaper changes grow from the centre of the screen in 180 ms. Wofi runs as a normal floating window so Niri also animates utility menus, clipboard history, emoji and password prompts. The app launcher keeps the previous 394 × 328 logical-pixel size. Password prompts center text vertically in their compact window. Password prompts and clipboard menus disable Wofi caching. Waybar, Wofi hover effects, and wallpaper transitions use the matching quadratic ease-out curve, cubic-bezier(0.333333, 0.666667, 0.666667, 1), with 180 ms durations. See Niri animations.

Click the hotspot icon beside the tray to start or stop sharing. Right-click it, or press Super+Shift+H, for credentials, Change password, and connection settings. Password entry is masked and accepts 8–63 ASCII characters or 64 hexadecimal digits (raw keys support WPA2 only). Changing an active hotspot's password restarts that hotspot; connected devices must reconnect. The first start creates a hotspot named Hype-Niri with a random password. It prefers 5 GHz on channel 36, uses 2.4 GHz on adapters without 5 GHz, and retries on 2.4 GHz if 5 GHz activation fails. The saved profile keeps the working band for later starts. Each activation attempt allows 35 seconds for NetworkManager to finish; busy actions show a notification. Security uses NetworkManager’s WPA2/WPA3 Personal setting, RSN, AES/CCMP, and optional protected management frames; WPA3 negotiation requires compatible adapter, supplicant, and client support. Starting an older saved hotspot upgrades these settings without changing its password and restarts it if needed. Starting it may disconnect Wi-Fi on the same adapter. Internet sharing requires an upstream connection, such as Ethernet, USB tethering, or another Wi-Fi adapter. The installer includes dnsmasq and configures DHCP/DNS access on hotspot-capable Wi-Fi interfaces when enabling UFW.

Launcher and utility menus use Wofi. If menus stop opening, run wofi --version and check ~/.config/wofi/config and ~/.config/wofi/style.css. Keep normal_window=true so Niri controls opening and closing animations. Menus stay open when they lose focus; pick an entry or press Esc to close them. Menu shortcuts and Waybar menu buttons toggle consistently: the first activation opens a menu, and the next closes the open Wofi menu without choosing an action. This covers the launcher (Super+A), wallpaper picker (Super+Shift+W), hotspot controls (Super+Shift+H), display settings (Super+Shift+D), clipboard (Super+V), emoji (Super+.), and power menu (Super+Shift+Delete).

Cloudflare's native tray client starts with the desktop when installed, showing its cloud status icon. The fallback WARP indicator hides while the native client runs.

Waybar volume and brightness scrolling filters small touchpad movements with a 1.0 smooth-scrolling threshold. Both controls use 1% steps (rounded to hardware units for brightness), and brightness ramps between values. Volume changes never queue behind an active change, and notifications do not hold either control's input lock. Brightness stops at 1%; decreasing an already lower value leaves it unchanged.

Installation includes OBS Studio and the LazyVim starter. Existing LazyVim settings are retained; other Neovim configurations are backed up before replacement. Open nvim to download plugins on first launch, then run :LazyHealth.

A swayidle -w watcher holds a sleep delay inhibitor while the lock helper confirms the session is locked. Explicit suspend requests abort if that confirmation fails. Lid-close and other external requests remain subject to logind's five-second delay limit; see the swayidle documentation.


Repository Structure

.
├── alacritty/       # Fast, GPU-accelerated terminal configuration
├── fastfetch/       # System information fetch utility with custom logo
├── wofi/            # Application launcher styled for Monochrome
├── hypr/            # Hypridle + Hyprlock configuration
├── mako/            # Notification daemon configuration
├── niri/            # Core Niri compositor settings and rules
├── polkit/          # Polkit rules for NetworkManager and drive access
├── wallpapers/      # Default curated wallpapers
├── scripts/         # Desktop utility and control scripts
├── systemd/         # Automatic power service and OOM protection
├── stealth/         # Optional transparent Tor service and installer
├── tests/           # Installer, runtime and power-policy regression checks
├── waybar/          # Comprehensive status bar configuration
├── wireplumber/     # Audio routing and idle suspension
├── zsh/             # Shell config, Stealth commands, and Powerlevel10k theme
├── install.sh       # Automated installation script
├── pkglist.txt      # Master list of required packages
└── *.md             # Documentation files

Documentation

Checks

Regression checks use temporary fixtures and mocked system commands:

python3 tests/test-install.py
python3 tests/test-runtime.py
python3 tests/test-sleep.py
python3 tests/test-caffeine.py
python3 tests/test-auto-power-profile.py
python3 tests/test-warp-indicator.py
bash stealth/test-stealth.sh
bash stealth/test-install-stealth.sh
shellcheck install.sh scripts/*.sh stealth/*.sh systemd/*.sh
shfmt -l install.sh scripts/*.sh stealth/*.sh systemd/*.sh
prettier --check . --ignore-unknown
ruff check tests
ruff format --check tests

Static checks require ShellCheck, shfmt, Prettier, and Ruff. Shell formatting uses the four-space indentation in .editorconfig; ruff.toml also checks import placement.

About

A clean, professional, highly functional Wayland setup based on the Niri scrollable-tiling compositor and a minimalist Monochrome theme.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages