A unified, reproducible dotfiles setup for Arch Linux (CachyOS) featuring:

• Niri window manager (Wayland compositor)
• default unified theme system
• Mako notification daemon
• Waybar status bar
• Fish shell with Starship prompt
• One-command reproducible setup via yay and declarative package lists

git clone https://github.com/abbesm0hamed/dofs.git ~/dofs
cd ~/dofs

./install.sh

This will:

• Ensure yay is installed
• Install all packages from lists (system, desktop, wayland, etc.)
• Stow all dotfiles to ~/.config
• Apply the unified default theme
• Enable the Niri session in your display manager

Time: ~15-20 minutes

reboot

This setup includes:

• ✅ xwayland-satellite for X11 app compatibility (Discord, Steam, etc.)
• ✅ xdg-desktop-portal-gnome for better screen sharing
• ✅ greetd-tuigreet dispaly manager
• ✅ optimized autostart with proper service ordering

• ✅ One command installs everything
• ✅ Automatic validation before completion
• ✅ Declarative package management
• ✅ Reproducible setup

• Base development tools, git, network manager
• Fish shell, Starship prompt
• Bluetooth, SSH, power management tools...

• Node.js (fnm), Python, Rust, Go
• Docker, Kubernetes, Terraform
• Neovim, code quality tools, debuggers...

• Chromium, Zen Browser
• Nautilus file manager
• Slack, Discord
• Zathura PDF viewer
• And many more...

• Niri compositor
• Waybar status bar
• Mako notifications
• Screenshot, recording, clipboard tools

# List available themes
dofs/scripts/theme-manager.sh list

# Apply a theme
dofs/scripts/theme-manager.sh set default

# Check current theme
dofs/scripts/theme-manager.sh current

Edit the relevant file in packages/:

# Add to development tools
echo "my-new-package" >> packages/development.txt

# Reinstall
./install.sh

# Copy existing theme
cp -r .config/theme/default .config/theme/my-theme

# Edit colors in my-theme/theme.toml
vim .config/theme/my-theme/theme.toml

# Apply the theme
bash scripts/theme-manager.sh set my-theme

Edit .config/niri/config.kdl and reload:

niri msg action reload-config

• Check if Wayland is supported: echo $WAYLAND_DISPLAY
• Verify Niri is installed: which niri
• Check logs: journalctl -u niri

• Ensure theme files exist: ls .config/theme/default/
• Manually apply: bash scripts/theme-manager.sh set default
• Check Waybar reload: pgrep waybar

• Ensure yay is installed: which yay
• Check internet connection
• Try manual install: yay -S package-name

All screenshots are automatically saved to ~/Pictures/Screenshots and copied to clipboard.

The following are the custom keybindings configured for Neovim:

Note: This is not an exhaustive list. There are more keybindings available in other plugins. Check the plugin documentation for more details.

Press ALT + L to open the power menu, which provides options for:

• Logout
• Reboot
• Hibernate
• Sleep

• Keyboard Layout: Toggle between US and Arabic layouts using Super + Alt + Shift + Space
• Auto-tiling: Dynamic tiling layout
• Workspace Auto Back and Forth: Enabled
• Smooth Animations: Advanced animation system

• The Linux Cast Dotfiles
• Nvim Config by Allaman
• Chris Grieser Config