NyxNiri

A Material You desktop experience for Arch / CachyOS
_{Built on Niri and Noctalia V5 — and stays out of your way.}

   

_{Website · Watch demo on Bilibili · Join discussion on Reddit}

• Wallpaper Picker (Super+W) — static + live, search and categories.
• Color Sync — Noctalia V5 extracts palettes from wallpaper; mpvpaper + ffmpeg for video frames.
• Light/Dark Sync — GTK 3/4, XDG portal, Kitty, and browsers switch together.
• Eye Care (Super+N) — warmer color temperature, no blur, opaque windows.
• Scratchpad (Super+~) — persistent Kitty floating terminal.
• Orbit Launcher (Super+A / Super+MouseForward) — vector radial; apps, tools, links, AI/search dial (TOML-configurable).
• Shell & Terminal — Fish aliases for proxy/cache, Kitty cursor trails, Windows-style shortcuts.
• NyxMellow — dynamic fcitx5 skin: mellow geometry + Noctalia Material You palette.
• Presets — per-app flavor variants (e.g. kitty transparent); switch with one command, save your setup as a private preset, or edit it in $EDITOR.

curl -fsSL --connect-timeout 10 https://raw.githubusercontent.com/ech678/NyxNiri/main/install.sh | bash

# shallow clone: latest snapshot only; drop --depth 1 for full history
git clone --depth 1 https://github.com/ech678/NyxNiri.git ~/NyxNiri
cd ~/NyxNiri && ./install.sh

Coming soon — paru -S nyxniri-git, with updates handled by pacman.

# Standalone via gh-proxy.org
curl -fsSL --connect-timeout 10 https://gh-proxy.org/https://raw.githubusercontent.com/ech678/NyxNiri/main/install.sh | bash

# git clone via gh-proxy.org
git clone --depth 1 https://gh-proxy.org/https://github.com/ech678/NyxNiri.git ~/NyxNiri
cd ~/NyxNiri && ./install.sh

NyxNiri
├── install.sh                  # lightweight bootstrap entrypoint
├── nyxniri/                    # Python core engine (zero pip dependencies)
├── assets/                     # static assets (wallpapers, fcitx5 skin templates)
└── configs/
    ├── niri/                   # window manager (.kdl, .toml)
    │   └── scripts/            # Orbit launcher, wallpaper picker & scratchpad scripts
    ├── noctalia/               # shell + theme sync
    ├── xdg-desktop-portal/     # portal routing (Settings / screencast)
    ├── kitty/                  # terminal
    ├── fish/                   # aliases + functions
    ├── fastfetch/              # system info
    ├── zed/                    # editor
    └── starship.toml           # prompt

Put shell scripts in ~/.config/NyxNiri/hooks/ to run your own finishing work after every normal config deploy. Scripts ending in .sh run in filename order with a 30-second limit; a failed or timed-out script is reported without blocking the rest. nyxniri test skips these hooks, and ordinary uninstall keeps them.

Some apps ship flavor variants — presets layer between defaults and your __custom__ files, so switching never touches your own tweaks.

Built-in official presets:

• kitty:
  • default: standard 90% opacity
  • transparent: 75% higher translucency flavor
• niri:
  • default: minimalist frameless look (default)
  • glow: enables 2px outline and 28px soft diffused ambient glow (improves focus visibility across tiled windows)
  • glow-material-you: focus glow follows Noctalia's current Material You palette

Official presets update with nyxniri update; private ones live in ~/.config/NyxNiri/presets/.

The GTK theme and fisher plugin manager deploy automatically with a full install; the items below are opt-in.

NyxMellow fcitx5 skin: mellow rounded shape matching Noctalia color palette (auto light/dark switch). nyxniri fcitx install registers it as a template and re-renders on wallpaper/theme changes. Opt-in only.

_{NyxMellow skin in light and dark mode}

Wallpaper & video pack: high-res wallpapers and live videos (~100MB) live in wallpaper-collection. Opt-in during install or download anytime via nyxniri wallpapers.

Noctalia Greeter: greetd login screen matching Noctalia style, nyxniri greeter install installs greetd + noctalia-greeter (AUR), backs up existing configuration, configures Polkit rules, then switches the next boot to greetd without ending the current session, a failed switch or nyxniri greeter uninstall restores the previous display manager

nyxniri manages install, snapshots and diagnostics. Interactive deployments create a snapshot in ~/.config/NyxNiri/backups/ by default.

Legacy Bash users must run the current bootstrap shown above before using these commands. The old nyxniri update cannot perform the directory migration.

Top-level

Deploy

Snapshots

System

Uninstall

Extensions

nyxhelp is a compact fzf-based reference for the CLI, shell helpers, and core keybindings:

[brightness]
enable_ddcutil = false

git -C ~/.local/state/noctalia/plugins/sources/community/repo reset --hard HEAD
git -C ~/.local/state/noctalia/plugins/sources/official/repo reset --hard HEAD

sudo bash -c 'cat > /etc/polkit-1/rules.d/50-noctalia-greeter.rules << EOF
polkit.addRule(function(action, subject) {
    if (action.id == "org.noctalia.greeter.sync-appearance" &&
        subject.isInGroup("wheel")) {
        return polkit.Result.YES;
    }
});
EOF'

nyxniri theme sync
# Or manually:
rm -f ~/.config/gtk-4.0/gtk.css ~/.config/gtk-4.0/noctalia.css ~/.config/gtk-3.0/gtk.css ~/.config/gtk-3.0/noctalia.css

Contact & Community:

• Telegram Channel: @linux_ricing
• QQ: 2040244628 · Linux Ricing Group: 631425889
• Sponsor: Afdian · Bug reports: GitHub Issues

Special Thanks & Contributors:

• @zhuhuaian, @Krits03, @Yulljie — community management & support
• @TyhLxxxhLrqTq — companion wallpaper site (in development)

Thanks to:

• RanXOM/glassy-niri — blur effects reference
• SHORiN-KiWATA/shorin-niri — heavily referenced
• sanweiya/fcitx5-mellow-themes — mellow shape source for NyxMellow skin
• StarWhiteIsBusy/Round-Simple-Fcitx5-Skin — Noctalia color-sync pattern reference
• doctorlogix — website design inspiration

Recommended:

• h465855hgg/noctalia-lyrics — status bar lyrics widget
• Ocfeather/chrome-niri-opacity — browser opacity script