My niri dotfiles with Noctalia shell

---

Showcase

niri-showcase.mp4

---

Quick Install:

Warning

Don't run random scripts blindly Always verify PKGBUILDs and bash scripts

Manual and scripted install are meant to be installed on a new system. I recommend you do the manual install on a pre-existing arch system.

git clone https://github.com/seraphicfae/niri-dotfiles
cd niri-dotfiles
./setup.sh

---

Goals and scope of my dotfiles

• Avoid writing to root and opt for local/user changes (besides packages).
• Intentionally stay minimal and let the user customize their choices.
• Follow XDG Base directory specification, and use systemd whenever possible.
• Sensible configs for apps, niri, and related tooling (scripts).
• Avoid the AUR whenever possible, and as much as possible.

Even though these are my dotfiles, I try to keep out changes that would only make sense on my machine, and may break configs for others. I created the SKIP ME section in setup.sh for this very reason. I do not want my dotfiles to be intrusive on user's home directory. While you can install these on a prebuilt system, if you blindly paste commands, you could break your system. This is a problem with every dotfile, but I try to minimize this issue when possible.

---

Manual Install: (Advanced users)

Dependencies

sudo pacman -S \
alacritty adw-gtk-theme base-devel breeze ddcutil dms fastfetch \
ffmpegthumbnailer fish imagemagick imv inter-font libnotify ly \
matugen mpv niri noto-fonts-cjk noto-fonts-emoji papirus-icon-theme \
qt6-wayland starship ttf-jetbrains-mono-nerd wl-clipboard \
xdg-desktop-portal-gnome xwayland-satellite zed

git clone https://aur.archlinux.org/qtengine
cd qtengine
makepkg -si

Steps

cd niri-dotfiles

cp -r .config/* "$HOME/.config/"

cp -r .local/share/* "$HOME/.local/share/"

cp -r .local/state/* "$HOME/.local/state/"

cp -r Pictures/ "$HOME/Pictures"

gsettings set org.gnome.desktop.interface gtk-theme 'adw-gtk3-dark'
gsettings set org.gnome.desktop.interface icon-theme 'Papirus'
gsettings set org.gnome.desktop.interface font-name 'Inter 11'
gsettings set org.gnome.desktop.interface cursor-theme 'breeze_cursors'
gsettings set org.gnome.desktop.interface cursor-size '24'
gsettings set org.gnome.desktop.interface color-scheme 'prefer-dark'
gsettings set org.gtk.gtk4.Settings.FileChooser show-hidden true
gsettings set org.gtk.gtk4.Settings.FileChooser sort-directories-first true

ln -sf /usr/share/themes/adw-gtk3/gtk-4.0/libadwaita.css "$HOME/.config/gtk-4.0/"

Finalizing

sudo systemctl enable ly@tty2

systemctl --user add-wants niri.service dms.service

chsh -s /usr/bin/fish

---

FAQ / Common Issues

Note for Cachyos
Due to CachyOS using a mix of custom repos for packages,
it's likely to not work well with the script. Use at your own risk.

Qt themes are broken!
Install qtengine and configure it.

The screen recording keybind isn't working!
Install wl-screenrec via cargo or the AUR.

My screen is grey/there's no wallpaper!
Super + W and choose which wallpaper you want!

My Display Manager is black/can't log in
This is likely due to multiple display managers active (Sddm, Greeter, etc).
Press alt + ctrl + f3 to switch to a different tty, and disable your old display manager.